~ / rigs / chrisgagne / grounded-forge

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.

↗ GitHub ★ 8 MIT updated 27d ago project Claude CodeCodex Claude plugin
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~6.4k tokens
Heavy · median rig: 2.3k · breakdown
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)

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)

eventmatcherruns
PreToolUseWrite|Editpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/validate-deep-ref.py"
PreToolUseWrite|Editpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/block-derived-index.py"
PreToolUseBashbash "$CLAUDE_PROJECT_DIR/scripts/git-hooks/pre-push"

Similar rigs

copied ✓