CodyAMaughan/agent-first-engineering
A curriculum + an agent-agnostic scaffolder for agent-first software engineering: design your codebase so AI coding agents (Claude Code, Codex, Cursor) succeed.
ARCHETYPE
Skill Collector
Ten-plus skills loaded on demand. A procedural-knowledge library.
Copy this rig
# review before running: this installs third-party code
$ npx degit CodyAMaughan/agent-first-engineering/.claude ./rig-agent-first-engineering # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/author-curriculum .claude/skills/author-curriculum $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/check-understanding .claude/skills/check-understanding $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/create-mvp .claude/skills/create-mvp $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/feature-lifecycle .claude/skills/feature-lifecycle $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/quality-loop .claude/skills/quality-loop $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/scaffold-agent-project .claude/skills/scaffold-agent-project $ npx degit CodyAMaughan/agent-first-engineering/.agents/skills/tend-wiki .claude/skills/tend-wiki $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-agent-context-update .claude/skills/speckit-agent-context-update $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-analyze .claude/skills/speckit-analyze $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-checklist .claude/skills/speckit-checklist $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-clarify .claude/skills/speckit-clarify $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-constitution .claude/skills/speckit-constitution $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-git-commit .claude/skills/speckit-git-commit $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-git-feature .claude/skills/speckit-git-feature $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-git-initialize .claude/skills/speckit-git-initialize $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-git-remote .claude/skills/speckit-git-remote $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-git-validate .claude/skills/speckit-git-validate $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-implement .claude/skills/speckit-implement $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-plan .claude/skills/speckit-plan $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-specify .claude/skills/speckit-specify $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-tasks .claude/skills/speckit-tasks $ npx degit CodyAMaughan/agent-first-engineering/.claude/skills/speckit-taskstoissues .claude/skills/speckit-taskstoissues
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/CodyAMaughan/agent-first-engineering/main/.claude/agents/code-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/lesson-reviewer.md https://raw.githubusercontent.com/CodyAMaughan/agent-first-engineering/main/.claude/agents/lesson-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/qa-adversary.md https://raw.githubusercontent.com/CodyAMaughan/agent-first-engineering/main/.claude/agents/qa-adversary.md $ curl -fsSL --create-dirs -o .claude/agents/qa-verifier.md https://raw.githubusercontent.com/CodyAMaughan/agent-first-engineering/main/.claude/agents/qa-verifier.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "sh .agent/hooks/git-safety.sh"
}
]
},
{
"matcher": "Read",
"hooks": [
{
"type": "command",
"command": "sh .agent/hooks/secret-scan.sh"
}
]
}
]
}
} Skills (22)
author-curriculumcheck-understandingcreate-mvpfeature-lifecyclequality-loopscaffold-agent-projecttend-wikispeckit-agent-context-updatespeckit-analyzespeckit-checklistspeckit-clarifyspeckit-constitutionspeckit-git-commitspeckit-git-featurespeckit-git-initializespeckit-git-remotespeckit-git-validatespeckit-implementspeckit-planspeckit-specifyspeckit-tasksspeckit-taskstoissues
Subagents (4)
| code-reviewer model: inherit | Expert code review specialist. Use proactively immediately after writing or modifying code. Reviews for correctness, security, and maintainability in a fresh context; reports findings, does not edit. |
| lesson-reviewer model: inherit | Adversarial reviewer for curriculum lessons. Use proactively after writing or editing a lesson/phase to grade it against the author-curriculum checklist and verify its citations in a fresh context. Re |
| qa-adversary model: inherit | A precision-first grounded reviewer for the repo's own tooling (hooks, test scripts, the orchestrator). It reads the target files and returns only the FEW sharpest, real, reproducible issues — each ci |
| qa-verifier model: inherit | A hostile skeptic that REPRODUCES a candidate finding against the real code in a throwaway sandbox (or DROPS it) and classifies its severity critical/high/low/nitpick. Defaults to dropping — a claim i |
Hooks (5)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Bash | sh .agent/hooks/git-safety.sh |
| PreToolUse | Read | sh .agent/hooks/secret-scan.sh |
| Stop | * | sh .agent/hooks/test-gate.sh |
| PreCompact | * | sh .agent/hooks/capture-learnings.sh |
| SessionStart | * | sh .agent/hooks/load-memory.sh |
Similar rigs
mahendrjy/dotfiles
My automate dotfiles
Skill Collector 535 tok ·
D4lD4r/inubit-mcp-server
Local stdio MCP server for operating and diagnosing INUBIT 8.1 integration servers from AI assistants such as Claude Code
Skill Collector 530 tok ·
alfredoperez/speckit-companion
VS Code extension for spec-driven development — manage specs, workflows, and steering docs for AI CLI tools (Claude Code, Gemini CLI, Copilot CLI)
Skill Collector 3.1k tok ·
yoonation/ai-grounded
Harness engineering for AI coding agents. Guides steer the agent before it acts, sensors catch what it got wrong after: a project constitution and concern catalogs, 12 read-only review agents, a 12-gate commit chain, and loop closure that b
Orchestrator 5.4k tok ·