Contracts Implement

Prerequisites

• Required: contracts/<feature-folder>/01-problem-analysis.md or contracts/<feature-folder>/02-solutions.md
• Required: attached_repos read from 01-problem-analysis.md or 02-solutions.md frontmatter

Smart Defaults

Before starting, determine active feature:

Important: Always Fresh Implementation

/contracts-implement  # First implementation
/contracts-implement  # Re-implements EVERYTHING from scratch

Every call:

1. Reads all current docs
2. Implements code fresh
3. Writes tests based on 02-solutions.md
4. Creates 03-implement-logs.md as progress log

If you only want to fix a bug, use /contracts-review "bug description" instead.

Checklist

You MUST complete these items in order:

1. Load all documents — Read everything in contracts/<feature-folder>/
2. Verify prerequisites — Ensure 01-problem-analysis.md or 02-solutions.md exists
3. Create implementation plan — From 02-solutions.md or requirements
4. Implement each step — Using sub-agents for isolation
5. Write tests — Based on 02-solutions.md specs
6. Run tests — Verify all tests pass
7. Create 03-implement-logs.md — Auto-log progress and deviations
8. Ask user: "Would you like to move to the next step (contracts-tests)?"
   • If yes → invoke /contracts-tests
   • If no → workflow complete

Documents Used

Sub-Agent Pattern

Main Agent (contracts-implement)
    │
    ├── Sub-agent: Step 1 (repo: frontend)
    │   Input: 02-solutions.md step, attachedRepos context
    │   Output: implemented code, test file
    │
    ├── Sub-agent: Step 2 (repo: api)
    │   Input: 02-solutions.md step, attachedRepos context
    │   Output: implemented code, test file
    │
    └── ...

Multi-Repo Implementation

When attached_repos is defined in frontmatter, dispatch sub-agents to each repo:

1. Read frontmatter — Get attached_repos from 01-problem-analysis.md or 02-solutions.md
2. Plan per-repo — Identify which steps go to which repos
3. Dispatch to repos — Use GitNexus MCP or worktree isolation
4. Track progress — Log repo, files, and tests per step

03-implement-logs.md Auto-Log Template

Created automatically during implementation:

---
ai_summary: "Implementation completed"
ai_warnings: ["Deviated from contract in Step 2"]
ai_generated_at: "2026-03-26T10:00:00Z"