~ / rigs / jintomjose / mini-software-factory

jintomjose/mini-software-factory

A one-person software factory for coding agents: artifact chain (intent, spec, plan), CLAUDE.md, skills, hooks, verifier and reviewer subagents. Copy into any repo.

↗ GitHub ★ 0 MIT updated 1mo ago project Claude Code
stack: Python
share on X
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
~843 tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
4/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · details
Quality 36/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit jintomjose/mini-software-factory/.claude ./rig-mini-software-factory  # 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 jintomjose/mini-software-factory/.claude/skills/capture-intent .claude/skills/capture-intent
$ npx degit jintomjose/mini-software-factory/.claude/skills/review-pr .claude/skills/review-pr
$ npx degit jintomjose/mini-software-factory/.claude/skills/write-spec .claude/skills/write-spec
$ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/jintomjose/mini-software-factory/main/.claude/agents/reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/verifier.md https://raw.githubusercontent.com/jintomjose/mini-software-factory/main/.claude/agents/verifier.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Bash(git push --force*)",
      "Bash(git push origin main*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect_paths.py\""
          },
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/block_secrets.py\""
          }
        ]
      }
    ]
  }
}

Skills (3)

Subagents (2)

reviewerReviews a pull request against REVIEW.md and the feature's spec. Use via /review-pr after the verifier passes. Produces findings with severities. Never approves, merges or edits.
verifierChecks a finished change against its plan.md before review. Use after building, before /review-pr. Runs tests and build, compares the diff to the plan, and reports. Never edits code.

Hooks (2)

eventmatcherruns
PreToolUseEdit|Write|MultiEditpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/protect_paths.py"
PreToolUseEdit|Write|MultiEditpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/block_secrets.py"

Permissions

deny (4)
Read(./.env)
Read(./.env.*)
Bash(git push --force*)
Bash(git push origin main*)
ask (0)
—
allow (0)
—

Similar rigs

copied ✓