[zvi-fried]

What this template does

Adds The Code Architect, a read-only architecture planning and review template at engineering/code-architect/.

One self-contained architecture skill selects planning or review mode. Each mode supplies its scope, expert output contract, checks, and report sections. Both use the same workflow, expert definitions, and contracts inside the skill's references/ folder.

The coordinator seats a small expert panel based on the problem. A shared Librarian selects exact book editions; experts apply their own knowledge of those books and trace practices to architecture evidence. A standing Tech lead researches current sources. The coordinator verifies the evidence and writes the final report, including strengths, risks, tradeoffs, and any missing production proof. The AI expert also checks relevant skills, plugins, MCP interfaces, and instruction files against their published standards.

Structure and contracts

engineering/code-architect/
├── plugin.json
├── README.md
├── ai.nanoco.nanoclaw/context/instructions.md
└── skills/architecture/
    ├── SKILL.md
    ├── references/
    │   ├── planning.md
    │   ├── review.md
    │   ├── workflow.md
    │   ├── agents/
    │   └── contracts/
    └── evals/evals.json

• Planning uses contracts/expert-planning-proposal.json; review uses contracts/expert-review-analysis.json.
• The Tech lead uses contracts/tech-lead-current-brief.json in both modes.
• Assignment contract paths resolve from the skill's references/ directory. The coordinator provides the resolved contract to each isolated expert.
• The expert schemas share definitions through local $ref links. Expert interface rules live once in agents/expert-protocol.md.
• The persona routes requests and controls delivery. The two old skill entry points are removed; their mode instructions are references in the single skill.

Requires a host with fresh isolated subagents and web search. No MCP servers, scheduled tasks, credentials, paid service integrations, or bundled books. Implementation requires a separate user request.

Validation

• node scripts/check-templates.mjs: all 6 templates pass.
• node scripts/build-index.mjs: no index drift.
• claude plugin validate engineering/code-architect: passed.
• Skill frontmatter validation and npx skills add . --list: the single architecture skill is valid and discoverable.
• One-time checks confirmed 69 local links and 11 schema references resolve. No custom Python validator or CI step is added.
• Startup checks confirmed planning and review load from a standalone skill copy; an ordinary PR/debugging request does not trigger the skill. These checks do not test full panel execution or final report quality.