By ryanthedev
Guides structured software engineering via classic texts: research vague requests, build phased implementation plans with adaptive gates, then execute through build-review-commit cycles with agent dispatch. Covers design exploration, code auditing, refactoring, debugging, and test-first legacy modification.
Execute an approved plan through gated phases (BUILD → REVIEW → commit) with subagent dispatch. Use when a plan exists in .code-foundations/plans/ and the user wants it implemented — phased implementation, per-phase quality gates, orchestrator commits, and a final trust report.
Runs the scientific debugging method on an active bug — reproduce, locate, hypothesize, fix, verify, search for siblings. Use to chase a failing test, a flaky or intermittent failure, a crash, or any 'why is this broken' investigation, or to audit whether a debugging session was systematic.
Turn a feature request or research doc into a phased, build-ready implementation plan. Use after research, or whenever a change needs decomposition into phases with skills, models, and gates before building.
Extract and document what the user wants — even when they don't know yet. Use before plan, or standalone when exploring an idea.
Discovery, design, and implementation in one pass. Scopes phase work, makes design decisions, stubs the interface, implements it, then validates with tests.
Independent, execution-grounded review of a build phase against its done-when requirements. Runs the suite first, verifies each requirement with evidence and a trace, returns PASS or FAIL with specific findings.
Guides module and API design using APOSD principles: generates multiple design alternatives, compares them on information hiding and interface depth, and produces a documented design decision. For creating new module/API design; not for assessing existing designs (use aposd-reviewing-module-design) or routine-level design (use cc-routine-and-class-design).
Assesses existing module and interface design for complexity symptoms: information leakage, shallow interfaces, pass-through layers, and unknown unknowns. Produces a structured assessment — not transformations (use aposd-simplifying-complexity to edit) and not new-design generation (use aposd-designing-deep-modules).
Transforms complex code by applying APOSD's pull-complexity-downward principle: resolves error hierarchies, collapses configuration, and moves caller-side logic into modules. Produces edited code, not just assessment.
Verifies implementation completeness across functional correctness, error handling, concurrency, and security dimensions using APOSD's post-implementation checklist. Run after a coding task is nominally complete, not during active bug investigation (use cc-debugging).
Applies Clean Architecture's dependency-direction and SRP-by-actor rules to system-level boundary design: separates business logic from infrastructure, identifies actor-coupling risks, and enforces inward-pointing dependency arrows. For system scope (multiple components, layers, or services), not routine or module scope (use cc-routine-and-class-design).
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
AI that codes like a senior engineer. Checklists, quality gates, and verification built into every workflow.
Active development - Installed via the marketplace below (currently v5.3.0); no tagged GitHub releases yet. The build workflow and skills are benchmark-validated, but subagent orchestration is still being tuned — expect changes.
| Command | Purpose | When to Use |
|---|---|---|
/code-foundations:research | Clarify what you want through facilitated conversation | Exploring ideas |
/code-foundations:plan | Create implementation-ready plans | Feature planning |
/code-foundations:build | Execute plans with quality gates | Implementing approved plans |
/code-foundations:debug | Scientific debugging with task tracking | Bug hunting |
Why this exists: LLMs write code fast. Fast code without engineering discipline creates debt. This plugin loads proven checklists and mental models so Claude applies them automatically.
Three commands work together: Research clarifies intent, Plan creates the plan, Build executes it.
/code-foundations:research "add notification system"
↓
.code-foundations/research/2026-01-30-notifications.md
↓
/code-foundations:plan .code-foundations/research/2026-01-30-notifications.md
↓
.code-foundations/plans/2026-01-30-notifications.md
↓
/code-foundations:build .code-foundations/plans/2026-01-30-notifications.md
/code-foundations:research - Clarify What You WantFacilitated conversation to extract and document requirements.
User: "/code-foundations:research add user notifications"
→ Facilitated conversation
→ Progressive narrowing: purpose, actors, context, boundaries, needs, risks
→ Save confirmed requirements to .code-foundations/research/
/code-foundations:plan — Create the PlanResearches your codebase, audits available skills, then asks targeted questions.
User: "/code-foundations:plan add user notifications"
DISCOVER
├─ Search codebase for existing patterns
├─ Audit ALL available skills (from every installed plugin)
│ → "React Native project detected → react-native-foundations:coding"
│ → "Frontend UI work → design-for-ai:a11y-audit"
├─ Ask targeted questions (one at a time)
└─ Produce problem statement
EXPLORE (Medium/Complex)
├─ 2-3 structurally different approaches
└─ Pre-mortem (Complex)
DETAIL → SAVE → CHECK → CONFIRM → HANDOFF
├─ Phase specs with Skills field per phase
├─ Save plan to .code-foundations/plans/
├─ Subagent reviews plan with fresh eyes
├─ User confirms + corrections
└─ Handoff to /code-foundations:build
Skills loaded: ca-architecture-boundaries (system-level boundaries, for shaping approaches and phase seams). Module-level design skills (aposd-designing-deep-modules, etc.) are matched per phase and loaded during DETAIL, not here.
Task tracking: Creates progress tasks at startup so you can see where plan is in its flow.
/code-foundations:build - Execute the PlanGated execution with subagents. Each phase has mandatory quality checks.
User: "/code-foundations:build .code-foundations/plans/2026-01-30-notifications.md"
BRANCH GATE
└─ On main? → STOP. Create feature branch first.
FOR EACH PHASE:
┌────────────────────────────────────────────────────────────┐
│ BUILD Build-agent: discovery + design + implement │
│ ⛔ Loads pre-gate + implement standards │
├────────────────────────────────────────────────────────────┤
│ REVIEW Post-gate-agent checks quality (Full gate) │
│ ⛔ Cannot commit until reviewer returns PASS │
├────────────────────────────────────────────────────────────┤
│ COMMIT Orchestrator commits after gates pass │
└────────────────────────────────────────────────────────────┘
| Phase | Guidance | What Gets Enforced |
|---|---|---|
| BUILD | Baseline discipline (agent definition) + per-phase skills | DW→test traceability, stub → implement → validate, test anchoring, scope clamp, plus assigned skill checklists |
| REVIEW | Debiased review protocol (agent definition) + per-phase skills | Execute-first verification, per-requirement evidence + trace, anti-overcorrection verdict |
| VERIFY | performance-optimization, cc-refactoring-guidance | Performance regressions, refactoring opportunities, build + tests + lint |
Gate policy is adaptive: Full (BUILD + REVIEW), Standard (BUILD + tests), Minimal (BUILD only). Skills assigned per phase during plan's SAVE step — gates load only those skills; each agent carries its own protocol. Security-sensitive phases get a 3-sample majority-vote REVIEW.
The system saves every artifact to .code-foundations/build/. Per-phase commits enable rollback.
Discipline plugins for Claude Code — prompt engineering, agent dispatch, writing, search, and browser/DevTools control
System design interview preparation and architecture review — structured frameworks for distributed systems
React Native foundation skills — documentation search, diagnosis, debugging, design-first coding, and development tooling
Persistent memory for LLMs with search, multi-source docs, and dreaming. SQLite FTS5, markdown storage, git-tracked history.
npx claudepluginhub ryanthedev/code-foundationsVerification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
No description provided.
You work with me (Claude) - I guide your workflow and suggest next actions.
AI-powered development tools for code review, research, design, and workflow automation.
No description provided.
Focused agentic engineering workflow: design-doc, spec, plan, implement, tdd, refactor, review, address-pr-feedback, browser-verify, explain-visually, compress, branch, and commit.