~ / rigs / aleconf / claude-code-spec-scaffold

aleconf/claude-code-spec-scaffold

Opinionated scaffolding for spec-driven AI coding — so your sessions leave behind artefacts, not scrollback.

↗ GitHub ★ 1 MIT updated 4mo ago project Claude Code
share on X
ARCHETYPE
Minimalist
Lean instructions, few tools, tiny context tax. Lets the model think.
CONTEXT TAX · EVERY TURN
~1.1k tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
2/5
Pre-tool screening hook · No YOLO mode · details

Copy this rig

# review before running: this installs third-party code
$ npx degit aleconf/claude-code-spec-scaffold/.claude ./rig-claude-code-spec-scaffold  # 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 aleconf/claude-code-spec-scaffold/.claude/skills/grill-with-docs .claude/skills/grill-with-docs
$ npx degit aleconf/claude-code-spec-scaffold/.claude/skills/karpathy-guidelines .claude/skills/karpathy-guidelines

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": "ExitPlanMode",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR:?CLAUDE_PROJECT_DIR is not set}/.claude/hooks/require-plan-doc.sh"
          }
        ]
      },
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'INSTRUCTION: Before editing or writing code, you must invoke the karpathy-guidelines skill via the Skill tool. If this is a planning session, invoke grill-with-docs first.'"
          }
        ]
      }
    ]
  }
}

Skills (2)

Hooks (2)

eventmatcherruns
PreToolUseExitPlanMode${CLAUDE_PROJECT_DIR:?CLAUDE_PROJECT_DIR is not set}/.claude/hooks/require-plan-doc.sh
PreToolUseEdit|Writeecho 'INSTRUCTION: Before editing or writing code, you must invoke the karpathy-guidelines skill via the Skill tool. If this is a planning session, invoke grill-with-docs first.'

Similar rigs

copied ✓