3a-plugin

Record an architecture decision as an ADR in .3a/decisions/.

Plan an AI agent project — gather requirements, define architecture, produce a roadmap.

Check project progress and get next steps.

Use when a developer asks about agent design best practices, patterns, or how to make a better agent. Provides curated guidance on architecture patterns, tool design, prompt engineering, error handling, and other quality aspects of agent development. Triggers on: "best practice", "how should I design", "good agent", "agent pattern", "multi-agent", "tool design", "prompt design", "3a guide", "advice", "is this a good approach", "what pattern", "single vs multi agent", "how to structure my agent". Not for project planning — use 3a-plan. Not for progress tracking — use 3a-track. Not for stage-gate reviews — use 3a-review. Not for implementation — delegate to aws-agents.

Use when a developer wants to plan an AI agent project before building it. Gathers requirements, defines architecture, and produces an execution roadmap. Triggers on: "plan my agent", "what should I build", "agent architecture", "requirements", "design my agent", "how should I structure", "roadmap", "3a plan", "planning", "before I start building". Not for actual implementation — delegates to aws-agents skills. Not for tracking progress — use 3a-track. Not for stage-gate reviews — use 3a-review.

Use when a developer is about to transition between project phases and needs a readiness check. Validates that prerequisites are met before moving from planning to implementation, implementation to deploy, or deploy to production. Triggers on: "am I ready to deploy", "review", "readiness check", "pre-deploy", "pre-production", "gate check", "3a review", "can I move on", "is my agent ready", "checklist", "before I deploy", "go to production". Not for creating a plan — use 3a-plan. Not for tracking progress — use 3a-track.

Use when a developer wants to check progress, understand where they are in their agent project, or figure out what to do next. Reads the roadmap and project state, then provides a status report with next steps. Triggers on: "where am I", "what's next", "status", "progress", "what should I do now", "3a status", "track", "stuck", "lost", "which phase", "next step". Not for creating a plan — use 3a-plan first. Not for stage-gate reviews — use 3a-review.

2 hooks across 2 events