~ / rigs / jin-ninini / readme-example

jin-ninini/readme-example

Describe the main objective of the project

↗ GitHub ★ 0 MIT updated 1mo ago project Claude Code
field: AI / ML workflow: Planning & specs
stack: Python
share on X
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
~923 tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
4/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · Sandbox or ask-first rules · details
Quality 43/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit jin-ninini/readme-example/harness/.claude ./rig-readme-example  # 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 jin-ninini/readme-example/refactor/.claude/skills/refactor-project .claude/skills/refactor-project
$ curl -fsSL --create-dirs -o .claude/agents/evaluator.md https://raw.githubusercontent.com/jin-ninini/readme-example/main/harness/.claude/agents/evaluator.md
$ curl -fsSL --create-dirs -o .claude/agents/planner.md https://raw.githubusercontent.com/jin-ninini/readme-example/main/harness/.claude/agents/planner.md

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

{
  "permissions": {
    "ask": [
      "Bash(git push:*)",
      "Bash(git reset --hard:*)",
      "Bash(git clean:*)",
      "Bash(git branch -D:*)",
      "Bash(rm -rf:*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit|NotebookEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/contract_gate.py\""
          }
        ]
      }
    ]
  }
}

Skills (1)

Subagents (2)

evaluatorUse after implementation to judge the result against the Definition of Done in PROGRESS.md. Runs real checks in a fresh context so the generator never grades its own work. Never edits files.
plannerUse before implementing any non-trivial task. Reads the codebase, surfaces ambiguities, and drafts the Definition of Done and a step → verify plan. Never edits files.

Hooks (4)

eventmatcherruns
SessionStart*python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/context.py" session
UserPromptSubmit*python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/context.py" prompt
PreToolUseEdit|Write|MultiEdit|NotebookEditpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/contract_gate.py"
Stop*python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/stop_gate.py"

Permissions

deny (0)
—
ask (5)
Bash(git push:*)
Bash(git reset --hard:*)
Bash(git clean:*)
Bash(git branch -D:*)
Bash(rm -rf:*)
allow (0)
—

Similar rigs

copied ✓