architect

Design sprint architecture documentation and reviewer checklists with pass/fail adjudication.

7|2|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/robconery/crap-code --skill architect-robconery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/robconery/crap-code/tree/main/.pi/skills/architect
Command: npx skills add https://github.com/robconery/crap-code --skill architect-robconery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents weak or inconsistent technical decisions by turning sprint inputs into a clear architecture plan, an enforceable reviewer checklist, and a closing architectural verdict.

Core Features & Use Cases

  • Sprint architecture design: Creates /docs/sprint/{name}/architecture.md with components, ports, data flow, and named pattern justifications, explicitly covering hex-lite layering, CQS, and SRP compliance.
  • Binary reviewer governance: Produces /docs/sprint/{name}/reviewer-checklist.md as a pass/fail gate layered on top of /docs/styleguide.md.
  • Decision tracking & change signaling: Writes new ADRs when cross-file or cross-sprint decisions occur and outputs Drizzle schema diffs for schema changes.
  • Strike-3 escalation directive: When a task fails three times, reviews the approach vs. implementation failure mode and issues a concise directive for the builder’s 4th attempt without writing production code.

Quick Start

Use the architect skill to generate /docs/sprint/{name}/architecture.md and /docs/sprint/{name}/reviewer-checklist.md for a given sprint named {name}.

Frequently Asked Questions about architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an architecture document for sprint planning?

A binary reviewer checklist enforces pass/fail governance gates layered on top of your styleguide.md. It provides a concise enforcement mechanism for sprint-close architectural adjudication, ensuring implementation matches the approved technical approach before final approval.

When do I need to write an ADR for schema changes?

You need to write an ADR when cross-file or cross-sprint architectural decisions occur during sprint execution. The process tracks decision rationale and signals changes by outputting Drizzle schema diffs for any database schema modifications, ensuring architectural shifts are documented and traceable.

How do I handle repeated task failures during a sprint?

For repeated task failures, a strike-3 escalation directive reviews the approach versus the implementation failure mode after three failures. It issues a concise directive for the builder's 4th attempt, focusing on architectural approach validation without writing production code directly.

What's the best way to validate CQS and SRP compliance before a sprint closes?

The best way to validate CQS and SRP compliance is through a sprint-close pass/fail architectural adjudication. This process requires mandatory named pattern justifications and explicit compliance citations in the architecture documentation to ensure architectural readiness before final sprint sign-off.