Investiture skill
Investiture adds eight Claude Code skills to a project: project doctrine, architecture enforcement and a repository audit.
- 55 ★ on the repository
- Last commit
Extended access
Why this level
- The installer writes skills and folders into the project, and the new-project script installs Homebrew, Node.js and Claude Code on your machine.
Install
- Works in
Manual install
npx investiture initThe first command of Add to an existing project. Then `/invest-backfill` in Claude Code.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The installer writes skills and folders into the project, and the new-project script installs Homebrew, Node.js and Claude Code on your machine.
This is third-party code. Review the repository files before installing.
What it does
Investiture is a project scaffold with clean architecture, structured doctrine and a skill chain that enforces it. `npx investiture init` adds eight skills in `.claude/skills/` and six research schemas in `vector/schemas/` to an existing project: persona, JTBD, assumption, interview, competitive and blue ocean. Then `/invest-backfill` surveys the code and writes `VECTOR.md`, `CLAUDE.md` and `ARCHITECTURE.md`. The skills split into a doctrine chain and an audit chain: scan, inventory, audit, remediate and verify. `npx investiture install-zvapps` adds a local React and Vite control panel for browsing doctrine and repository health, and `npx investiture update` pulls updates without touching your files.
Who it is for. Product teams and developers using Claude Code who want to fix a project's goals, architecture and rules in files and check code against them.
Good fit when
- A long-lived project has no architecture notes and the agent guesses the conventions each time.
- The agent breaks layers and import rules and they need to be fixed in doctrine.
- Before a refactor a repository audit with a list of found problems is needed.
- User research should follow ready schemas rather than scattered notes.
Not a fit when
- One narrow skill is needed: eight skills and `vector/` folders are excessive.
- You do not want doctrine files and research schemas appearing in the repository.
- The working agent is not Claude Code: the skills target it.
Example request
Run /invest-backfill for this project, write VECTOR.md and ARCHITECTURE.md, then audit the repository and show the findings.Limitations
GitHub metadata shows no licence, so reuse terms need confirming with the author. `npx investiture init` writes files into the project, and `install-zvapps` puts a separate React and Vite app into `zvapps/` that runs on port 3003. For a new project there is an `install.sh` script that installs Homebrew, Node.js and Claude Code, so it is worth reading before running. The doctrine and schemas study code and create documents, but decisions stay with you.
How to disable. Delete `.claude/skills/invest-*` and the `vector/` and `zvapps/` folders, and remove `.investiture-version` and the created doctrine documents by hand.
FAQ
Which skills are added?
Eight: a doctrine chain (`invest-backfill`, `invest-doctrine`, validation and enforcement) and an audit chain (scan, inventory, audit, remediate, verify remediation).
What does /invest-backfill create?
It surveys the codebase and writes three files: `VECTOR.md` with project doctrine, `CLAUDE.md` for new contributors and `ARCHITECTURE.md` with the technical spec.
What happens on update?
`npx investiture update` replaces the panel and active skills but leaves doctrine, `vector/` artifacts, `.env` and tracking data alone. `--dry-run` previews the changes.
Can I install without npm?
Yes, there is an `inject.sh` script run through `curl`. It is worth reading before running.
What is the control panel for?
A local app for browsing doctrine, editing `DESIGN.md` with a live preview and tracking repository health. Install it with `npx investiture install-zvapps`.
Discussion
No questions or reviews yet.
Related
Skills22 skills for the full Claude Code project lifecycle: setup and task scope, code review, pre-push checks and session notes.
Commands /implement, /design and /build, specialized agents and skills for Claude Code in a TypeScript project on Biome and Vitest
A Claude Code environment installer: CLAUDE.md, rules, skills, agents, hooks and two-layer project memory in one script
A Claude Code working configuration: a planner with per-milestone review, sub-agents and skills for analysis, refactoring and docs sync
An architecture coach skill: questions lead to ADRs, a diagram and a plan, and a repository is audited from its code
A shared set of skills, agents and hooks for Claude Code: design, phased sprints and notes kept outside the repository.
README in short
Shows adding skills to an existing project, the control panel, updates, starting a new project, prerequisites and the makeup of doctrine and layers.