| name | init-framework |
| description | Initialize the katachi framework directory structure |
| disable-model-invocation | true |
Initialize Framework
Initialize the katachi development framework directory structure in a project.
Context
You must load the following skills before proceeding.
Skills
katachi:framework-core - Workflow principles and task management
Process
1. Check Current State
Check if framework is already initialized:
- Does
docs/planning/ directory exist?
If yes, inform the user:
Framework directory structure already exists.
You can use these commands to create planning documents:
- `/katachi:vision` - Create project vision
- `/katachi:deltas` - Create the delta inventory
2. Create Directory Structure
Create the framework directories:
mkdir -p docs/planning docs/feature-specs docs/feature-designs docs/feature-plans docs/architecture docs/design
3. Create CLAUDE.md
If CLAUDE.md doesn't exist, create it with this template:
# Project: [Project Name]
## Quick Context
[TODO: Add 1-2 sentence description]
## Key Files
- `docs/planning/VISION.md` - Project vision
- `docs/planning/DELTAS.md` - Feature inventory
## Available Commands
Use `/katachi:` commands to work with the framework.
## Current Focus
[TODO: Update when starting a feature]
4. Next Steps
Inform the user about next steps:
Framework initialized! Here are the typical next steps:
For new projects:
1. `/katachi:vision` - Define what you're building
2. `/katachi:deltas` - Create the delta inventory
For existing projects with code:
Ask the user:
"This looks like an existing project with code. Would you like to run a full
project retrofit? This will discover your modules, create specs, designs,
decisions, and synthesize a vision document."
If yes → invoke the `katachi:retrofit-project` skill (it will take over from here)
If no → show individual commands:
- `/katachi:retrofit-spec <path>` - Document one module
- `/katachi:retrofit-design <ID>` - Create design from spec
- `/katachi:retrofit-decision <topic>` - Document one decision
- `/katachi:vision` - Create/synthesize vision
The deltas.py script is available at:
${CLAUDE_PLUGIN_ROOT}/scripts/deltas.py