domain
01Agent
How the engineering skills should consume this repo's domain documentation when exploring the codebase.
72 tagged adr, measured the same way as everything else here.
Browse within: architecture 23architecture-decision-records 15claude-plugin 14backstage 11developer-experience 11annotations 9architectural-decision-records 9code-documentation 9architecture-review 8ci 6prd 6product-management 6tdd 6agentic-engineering 5
Agent
How the engineering skills should consume this repo's domain documentation when exploring the codebase.
Agent
The skills speak in terms of five canonical triage roles. This file maps those roles to the label strings that actually exist in this repo's issue tracker.
Agent
The architecture document MUST reflect the reality of the code, not just the desired target state. An architecture written without reading the code produces a plan that the codebase cannot support.
codenamev/ai-software-architect
Agent
AI Engineer architecture reviewer. Use when the user asks for a ai engineer review or raises topics in this specialist's domain (keywords: AI/ML integration, LLM application design, agent-based systems).
codenamev/ai-software-architect
Agent
Implementation Strategist architecture reviewer. Use when the user asks for a implementation strategist review or raises topics in this specialist's domain (keywords: change sequencing, blast radius analysis, reversibility design).
codenamev/ai-software-architect
Agent
YAGNI Guardian & Simplicity Advocate architecture reviewer. Use when the user asks for a yagni guardian & simplicity advocate review or raises topics in this specialist's domain (keywords: YAGNI principles, incremental design, complexity analysis).
tosin2013/mcp-adr-analysis-server
Agent
GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
GiustoPiedimonte/agentic-engineering-marketplace
Agent
Use this agent to implement ONE approved, closed-scope cycle and open a PR. It is the serialized writer — never run two executors on overlapping files. Context: A pitch has been shaped and approved. user: "Ship the rate-limiter pitch." assistant: "I'll delegate this closed-scope cycle to the executor agent, which will…
GiustoPiedimonte/agentic-engineering-marketplace
Agent
Use this agent for read-only research — codebase investigation, library/API docs, papers, competitor source — feeding shaping/ADR decisions with grounded, cited evidence. Fan-out safe: run several in parallel. Never edits project code. Context: Shaping a pitch that needs grounding. user: "How does our auth handle…
GiustoPiedimonte/agentic-engineering-marketplace
Agent
Use this agent as a general adversarial verifier node in a graph: given ONE finding/claim/answer, try to kill it and return a real/not-real verdict with reasoning. Fan-out safe — run N in parallel (or with distinct lenses) as a gate before a finding is allowed downstream. Read-only. Distinct from reviewer (which…
Agent
Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
Agent
Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.
Agent
Assess the current codebase against the feature's spec, plan, and tasks, then append any remaining unbuilt work as new tasks to tasks.md so implement can complete it.
Agent
Reviewer of finished code (not of proposals — for that, use @architect). Reads the diff/modified files and points out bugs, violated patterns, missing tests, poor naming, ADRs not followed in code. Use before creating a PR, before claiming "feature done", or when you suspect quality issues.
Agent
Pragmatic QA that complements TDD with real exploratory testing. Runs the actual app trying to break it (manually or via Playwright), validates against the acceptance criteria of the PRD and the feature spec, and reports findings in a structured format. Invoked between phases or before marking a feature as done. Does…
Agent
Lightweight security reviewer (not a professional pen-test). Focuses on the practical OWASP top 10, leaked secrets, input validation, auth bypass, cross-tenant authorization, basic LGPD. Use before a release, after a change to auth/permissions/storage, or when touching sensitive data.
Agent
Cairn curator map subagent — one shard in, ≤15 candidate DEC/INV JSONL out. Spawned in parallel rounds of 4 during Phase 9b-curate.
Agent
Cairn curator reduce subagent — clusters all curator-map output, synthesizes the final 30-80 DEC/INV set, writes final.jsonl. Spawned once after every map subagent finishes.
Agent
Optional. Use only when the operator explicitly asks for a diff review or a DEC-drafting sweep. The default close path is the AI calling cairntaskcomplete with a summary.
Agent
Use this agent proactively when architectural decisions are being discussed in conversation. This agent detects keywords and patterns indicating architectural discussions and suggests capturing decisions as ADRs. Examples: Context: User is discussing which database to use for a new feature. user: "Should we use…
Agent
Use this agent proactively to audit code changes against accepted Architectural Decision Records. This agent checks if implementation follows documented architectural decisions and flags violations. Examples: Context: User has written code that might conflict with an accepted ADR. user: "I just implemented the new…
Agent
Use this agent when researching context, options, or best practices for an architectural decision. This agent analyzes the codebase and searches the web to gather information for ADR authoring. Examples: Context: User needs to research options for a new ADR. user: "I need to write an ADR about choosing a message…
Agent
Use this agent to author a new Architecture Decision Record (ADR). Hand it the decision, the alternatives, and the constraints; it returns a fully populated docs/adr/ADR-XXX-title.md following the conventions in the project's ADR skill. Use when a code change is architecturally significant: new dependency, contract…
Agent Claude Code
Use when you need a focused, parallel-dispatchable architectural review of a diff, a planned change, or an OpenSpec proposal against this repo's cross-cutting invariants — the doctrine written as prose in CLAUDE.md, spec/.md, and openspec/project.md, which has no .claude/rules/.md file of its own. Returns a structured…