chrisgagne/grounded-forge
Project once, retrieve distillations, create tools: a pre-loading retrieval architecture and tool builder for distributable, source-grounded assistants for complex, repeatable work in your known task domains.
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 24/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit chrisgagne/grounded-forge/.claude ./rig-grounded-forge # 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 chrisgagne/grounded-forge/.claude/skills/advise-from-corpus .claude/skills/advise-from-corpus $ npx degit chrisgagne/grounded-forge/.claude/skills/answer-from-corpus .claude/skills/answer-from-corpus $ npx degit chrisgagne/grounded-forge/.claude/skills/audit-attribution .claude/skills/audit-attribution $ npx degit chrisgagne/grounded-forge/.claude/skills/creating-applications .claude/skills/creating-applications $ npx degit chrisgagne/grounded-forge/.claude/skills/creating-corpus .claude/skills/creating-corpus $ npx degit chrisgagne/grounded-forge/.claude/skills/creating-distillations .claude/skills/creating-distillations $ npx degit chrisgagne/grounded-forge/.claude/skills/creating-lenses .claude/skills/creating-lenses $ npx degit chrisgagne/grounded-forge/.claude/skills/creating-tasks .claude/skills/creating-tasks $ npx degit chrisgagne/grounded-forge/.claude/skills/finding-resources .claude/skills/finding-resources $ npx degit chrisgagne/grounded-forge/.claude/skills/gridmaker-interview .claude/skills/gridmaker-interview $ npx degit chrisgagne/grounded-forge/.claude/skills/ingesting-images .claude/skills/ingesting-images $ npx degit chrisgagne/grounded-forge/.claude/skills/ingesting-resources .claude/skills/ingesting-resources $ npx degit chrisgagne/grounded-forge/.claude/skills/matching-references .claude/skills/matching-references $ npx degit chrisgagne/grounded-forge/corpus.commons/chrisgagne-agent-built-software/.claude/skills/review-change .claude/skills/review-change $ npx degit chrisgagne/grounded-forge/corpus.commons/chrisgagne-agent-built-software/apps/factory-warranty-full/factory/skills/factory .claude/skills/factory
$ curl -fsSL --create-dirs -o .claude/agents/ingest-auditor.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-auditor.md $ curl -fsSL --create-dirs -o .claude/agents/ingest-concept-linker.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-concept-linker.md $ curl -fsSL --create-dirs -o .claude/agents/ingest-discovery-scanner.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-discovery-scanner.md $ curl -fsSL --create-dirs -o .claude/agents/ingest-refiler.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-refiler.md $ curl -fsSL --create-dirs -o .claude/agents/ingest-refs-extractor.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-refs-extractor.md $ curl -fsSL --create-dirs -o .claude/agents/ingest-topic-linker.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/.claude/agents/ingest-topic-linker.md $ curl -fsSL --create-dirs -o .claude/agents/aar-facilitator.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/corpus.commons/demo/.claude/agents/aar-facilitator.md $ curl -fsSL --create-dirs -o .claude/agents/retro-facilitator.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/corpus.commons/demo/.claude/agents/retro-facilitator.md $ curl -fsSL --create-dirs -o .claude/agents/aar-facilitator.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/corpus.commons/demo/apps/aar-mode/.claude/agents/aar-facilitator.md $ curl -fsSL --create-dirs -o .claude/agents/retro-facilitator.md https://raw.githubusercontent.com/chrisgagne/grounded-forge/main/corpus.commons/demo/apps/retro-mode/.claude/agents/retro-facilitator.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": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/validate-deep-ref.py\""
},
{
"type": "command",
"command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/block-derived-index.py\""
}
]
},
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/scripts/git-hooks/pre-push\""
}
]
}
]
}
} Skills (15)
advise-from-corpusanswer-from-corpusaudit-attributioncreating-applicationscreating-corpuscreating-distillationscreating-lensescreating-tasksfinding-resourcesgridmaker-interviewingesting-imagesingesting-resourcesmatching-referencesreview-changefactory
Subagents (10)
| ingest-auditor model: opus | Pass I source-only audit of the 9-pass ingestion protocol, the same-family leg. Reads one deep reference cold against its converted source, traces every claim, fixes strips, marker corrections and ver |
| ingest-concept-linker model: opus | Pass H cross-link pass of the 9-pass ingestion protocol. Reads the mechanical concept-candidates payload and decides attach, merge, novel or drop for each candidate, writing a pending-decisions file ( |
| ingest-discovery-scanner model: opus | LLM leg of the discovery scan in the 9-pass ingestion protocol. Reads one converted source in full and adds to its mechanical-baseline `_planning/discovery/{slug}.json` the author's enumerated named m |
| ingest-refiler model: opus | Pass H re-filing pass of the 9-pass ingestion protocol. Reads a batch of sources' deep references against the assembled concept index and proposes, per source, credits on existing rows, topic filings, |
| ingest-refs-extractor model: opus | Pass H refs pass of the 9-pass ingestion protocol. Reads one deep reference's header and thesis and writes its reference-index fields (author, year, title, primary_topic, concept_tags) to `_planning/s |
| ingest-topic-linker model: opus | Pass H topic pass of the 9-pass ingestion protocol. Reads the assembled concept vocabulary and files every concept under topics (subject topics and cross-school debates), keeps only true synonyms, and |
| aar-facilitator model: sonnet | Use when a practitioner asks you to facilitate or coach them through an After-Action Review of a specific incident, project completion, or operational event. The agent hosts the six-phase AAR sequence |
| retro-facilitator model: sonnet | Use when a lead engineer asks you to coach them through a team retrospective. The agent hosts the seven-phase coaching loop (Phase 0 setup → Phase 0.5 experiment review → Phase 1 priming → Phase 2 dat |
| aar-facilitator model: sonnet | Use when a practitioner asks you to facilitate or coach them through an After-Action Review of a specific incident, project completion, or operational event. The agent hosts the six-phase AAR sequence |
| retro-facilitator model: sonnet | Use when a lead engineer asks you to coach them through a team retrospective. The agent hosts the seven-phase coaching loop (Phase 0 setup → Phase 0.5 experiment review → Phase 1 priming → Phase 2 dat |
Hooks (3)
| event | matcher | runs |
|---|---|---|
| PreToolUse | Write|Edit | python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/validate-deep-ref.py" |
| PreToolUse | Write|Edit | python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/block-derived-index.py" |
| PreToolUse | Bash | bash "$CLAUDE_PROJECT_DIR/scripts/git-hooks/pre-push" |
Similar rigs
MandalorianBatman/austere-axi
Coding agents write review pages in OpenUI Lang (a few hundred tokens, not a whole HTML page). You annotate them in the browser; notes go back by statement name and the agent patches only those. Local, MIT.
Minimalist 1.7k tok · · Q0
minhtran3124/claude-code-tokscope
Token usage per skill, subagent and phase for Claude Code: CLI, HTML report, live dashboard and benchmarks.
Pragmatist 1.0k tok · · Q17
thedammyking/factory
A Claude Code plugin that carries a one-line request through triage, spec, tickets, implementation, verification, review and PR to a merge decision made from facts.
Pragmatist 455 tok · · Q0
popmechanic/VibesOS
A GUI for Claude Code that makes it easy to vibe code simple, un-hackable apps
Pragmatist 3.4k tok · · Q3