Cc sdd new agent
Turn approved specs into long-running autonomous implementation. A minimal, adaptable SDD harness with Agent Skills for Claude Code, Codex, Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, and Antigravity.
npx -y skills add gotalab/cc-sdd --skill cc-sdd-new-agentAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Add or extend coding-agent support in cc-sdd by executing the SOP in docs/cc-sdd/sop-new-agent.md end-to-end. Use when introducing a new agent, adding a subagent-capable variant, or evaluating migration of an existing supported agent to skills-based templates.
SKILL.md
4.5 KB, as published. Nobody here has run it
CC-SDD New Agent Integration
Goal
Add a production-ready agent integration to tools/cc-sdd with complete research, implementation, and verification artifacts.
Use the existing SOP and templates in this repository instead of inventing a new process.
Default Operation Mode
Use plan-first as the default:
- First deliverable:
docs/cc-sdd/plans/agent-plan-{agent-id}.md - Second deliverable (after plan approval): implementation changes in
tools/cc-sdd/...
Do not skip the plan document unless the user explicitly requests direct implementation.
Collect Inputs First
Collect the minimum inputs before editing files:
- Target agent display name and agent id (kebab-case)
- Official documentation URL for command/agent/skills format
- Integration scope:
commands-only,commands+agents, orskills - Whether work type is
new-agentormigration
If any item is unclear, resolve it during Phase 1 research before creating implementation files.
Execution Workflow
1) Run Phase 1 Research
Read docs/cc-sdd/sop-new-agent.md and extract all required spec details from official docs:
- commands directory
- agent directory (if supported)
- documentation filename
- command invocation format
- YAML frontmatter schema for commands and agents (or skills)
- placeholders/arguments format
Record exact values (not assumptions) in the plan document.
2) Create Plan Document
Copy and fill:
docs/cc-sdd/templates/agent-plan-template.md
Include:
- Phase 1 research summary table
- Differences vs nearest existing agent pattern
- 5-step implementation plan
- changed-file list
- verification plan
Write the completed plan to:
docs/cc-sdd/plans/agent-plan-{agent-id}.md
Before implementation, ensure the plan explicitly states:
- integration scope (
commands-only,commands+agents,skills) - whether this is
new-agentormigration - compatibility impact and rollback approach
3) Choose Base Pattern and Implement
Pick the nearest existing implementation and copy from it:
commands-only: start fromtools/cc-sdd/templates/agents/codexor another commands-only agentcommands+agents: start fromtools/cc-sdd/templates/agents/claude-code-agentortools/cc-sdd/templates/agents/opencode-agentskills: start fromtools/cc-sdd/templates/agents/claude-code-skills
Start implementation only after the plan file exists and the user has confirmed to proceed.
Apply the standard 5 implementation steps from SOP:
- Update
tools/cc-sdd/src/agents/registry.ts - Add
tools/cc-sdd/templates/manifests/{agent-id}.json - Add
tools/cc-sdd/templates/agents/{agent-id}/... - Convert YAML frontmatter to target-agent format (keep body unless incompatibility is confirmed)
- Add
tools/cc-sdd/test/realManifest{AgentName}.test.ts
For skills integration, generate SKILL.md-based command packages under templates/agents/{agent-id}/skills/.
4) Handle Migration Cases
If the request is migration (or migration may be needed), read references/skills-migration.md and decide strategy before editing:
- Recommended default: additive migration (
{agent-id}-skillsas a new option) - Use in-place replacement only when explicitly requested
Always document compatibility impact and CLI flag impact in the plan.
5) Verify Before Reporting
Run verification in tools/cc-sdd:
npm testnpm run build && node dist/index.js --agent {agent-id} --dry-run- local temp-directory apply test with
--overwrite=force - language checks (
--lang ja,--lang en) - generated file count checks
If tests cannot run, explicitly report which step is blocked and why.
Completion Criteria
- Plan file exists at
docs/cc-sdd/plans/agent-plan-{agent-id}.md - Registry entry exists and routes to the new manifest id
- Manifest artifacts match target integration scope
- Templates render to expected target directories
- Real manifest test exists and passes
- Dry-run output matches expected artifact plan
- Plan document is updated with research evidence and verification notes
References
- SOP:
docs/cc-sdd/sop-new-agent.md - Plan template:
docs/cc-sdd/templates/agent-plan-template.md - Migration guide:
references/skills-migration.md - Plan checklist:
references/plan-output-checklist.md