How camilopolo1991-wq/the-forge works
The Forge is a Claude Code agent guard kit: it constrains tool use and scope, checks plans and run state, protects output, and records evidence for later audit. A principal workflow is an operator dispatching a goal; dispatch performs gates and manages the run, while the kit’s commands and hooks enforce checks and maintain logs, tickets, and record-repository changes. The README also documents redaction and post-run journal, plan, and reviewer checks. Relationships below are limited to README statements and visible source references; unsampled modules are included as capability nodes, but their internal call paths are not inferred.
Main entry points: loop_dispatch.py Goal dispatcher · _guardlib.py Guard helpers · loop_steplog.py Step-log reader · loop_conf.py Loop configuration
Components 24
Goal Dispatch
- Goal dispatcher
bin/loop_dispatch.py - Leader process count
bin/loop_procs.py - Goal worktrees
bin/loop_worktree.py - Dispatch gate
hephaestus/agent-hooks/dispatch-gate.py
Execution Guards
- Pre-tool guard
hooks/pretool-guard.py - Read-only guard
hooks/readonly-guard.py - Writer guards
hooks/writer-git-guard.py - Guard helpers
hooks/_guardlib.py - Output redaction
bin/loop_guard_run.py - Redaction engine
bin/loop_redact.py - Secret scanning
bin/loop_scan.py
Audit And Records
- Run journal
bin/loop_journal.py - Step-log reader
bin/loop_steplog.py - Ticket records
bin/loop_ticket.py - Record commit
bin/loop_record_commit.py - Record merge
bin/loop_record_merge.py - Run inventory
bin/loop_inventory.py - Run reports
bin/loop_report.py
Validation Tools
- Card and plan lint
bin/loop_card_lint.py - Run preflight
bin/loop_preflight.py - Change tripwire
bin/loop_tripwire.py
Shared Configuration
- Loop configuration
bin/loop_conf.py
Other components
- Operator
- Claude Code agent
Connections 20
- Operator → Goal dispatcher: dispatches goal
README.md - Goal dispatcher → Leader process count: counts leaders
bin/loop_dispatch.py - Goal dispatcher → Goal worktrees: manages worktrees
bin/loop_dispatch.py - Goal dispatcher → Dispatch gate: runs under gate
- Claude Code agent → Pre-tool guard: tool calls
README.md - Pre-tool guard → Guard helpers: uses helpers
hooks/pretool-guard.py - Read-only guard → Guard helpers: uses helpers
hooks/readonly-guard.py - Writer guards → Guard helpers: uses helpers
hooks/writer-git-guard.py - Operator → Output redaction: runs command
README.md - Output redaction → Redaction engine: redacts output
- Operator → Run journal: checks journal
README.md - Operator → Card and plan lint: lints plan
README.md - Card and plan lint → Step-log reader: reads step log
bin/loop_card_lint.py - Run journal → Step-log reader: reads step log
bin/loop_journal.py - Record commit → Step-log reader: reads step log
bin/loop_record_commit.py - Record commit → Goal worktrees: uses worktree operations
bin/loop_record_commit.py - Run preflight → Loop configuration: loads settings
bin/loop_preflight.py - Secret scanning → Redaction engine: uses detector
bin/loop_scan.py - Change tripwire → Loop configuration: loads settings
bin/loop_tripwire.py - Ticket records → Loop configuration: reads settings
bin/loop_ticket.py