How eirkkr/fieldkit works
Field Kit is shared guidance and Claude Code tooling that consumer repositories link rather than copy. The main workflow is: a developer opts a repository into the kit, Claude reads its always-on and task-specific guidance, then uses shared skills; hooks can enforce selected rules during tool calls, commits, or turn completion. Separate branches provide OpenSpec and Python-specific workflows, while machine-level setup registers hooks and the status line. Relationships for unsampled capabilities rely on README statements; source-level evidence is limited to the excerpts shown.
Main entry points: skills Shared skills · scripts Settings setup · conventions.py Rule logic · KIT.md Kit entry
Components 24
Shared guidance
- Kit entry
KIT.md - Conventions
conventions - Design records
docs/decisions
Agent workflows
- Shared skills
skills - Git skills
skills/push/SKILL.md - Change planning
skills/change-plan/SKILL.md - Change staging
skills/change-stage/SKILL.md - PR and merge
skills/pr/SKILL.md - OpenSpec skills
repo-skills - OpenSpec overlays
repo-skills-overlay - Workflow schemas
schemas - Python skills
python-skills
Rule enforcement
- Rule logic
hooks/conventions.py - Branch hook
hooks/pretooluse-branch-name.py - Merge hook
hooks/pretooluse-merge-message.py - Formatter hook
hooks/stop-autofix.py - Git hooks
hooks
Machine integration
- Settings setup
scripts - Settings editor
scripts/settings_edit.py - Status line
statusline
Other components
- Developer
- Consumer repo
- Claude Code
- Claude settings
Connections 25
- Developer → Consumer repo: opts in
README.md - Consumer repo → Kit entry: imports
README.md - Kit entry → Conventions: points to
README.md - Developer → Shared skills: invokes
README.md - Shared skills → Git skills: includes
README.md - Shared skills → Change planning: includes
README.md - Shared skills → Change staging: includes
README.md - Shared skills → PR and merge: includes
README.md - Developer → OpenSpec skills: opts into
README.md - OpenSpec overlays → OpenSpec skills: patches
README.md - Developer → Workflow schemas: opts into
README.md - Developer → Python skills: opts into
README.md - Branch hook → Rule logic: checks with
hooks/pretooluse-branch-name.py - Merge hook → Rule logic: checks with
hooks/pretooluse-merge-message.py - Git hooks → Rule logic: checks with
hooks/conventions.py - Claude Code → Branch hook: runs before tools
README.md - Claude Code → Merge hook: runs before tools
README.md - Claude Code → Formatter hook: runs at turn end
README.md - Developer → Git hooks: enables
README.md - Developer → Settings setup: installs
README.md - Settings setup → Settings editor: uses
scripts/register_hooks.py - Settings setup → Claude settings: registers hooks
README.md - Settings setup → Status line: links
README.md - Claude settings → Claude Code: configures
README.md - Design records → Developer: documents rationale
README.md