JPKB Project Initialization Workflow
Scaffold new projects in the JPKB repository with standardized documentation artifacts.
Execution Steps
- Gather Requirements
Before creating any files, clarify with user:
Required Question Default
✓ Project name? None — must ask
✓ Category/parent folder? Prompt with existing options
Project type? general
License preference? MIT
Brief description? "A new project"
Skip questions if context provides answers. If user says "init parametric-hinge in 3d-prints", don't re-ask.
- Confirm Target Path
Before creating files, confirm the full path:
Target: E:\Projects\JP KB\jpkb\projects<category><project-name>\
Wait for user confirmation or correction.
- Check for Existing Files
Before creating, check what already exists:
If Exists Action
README.md Skip — preserve existing
CHANGELOG.md Skip — preserve existing
LICENSE Skip — preserve existing
.gitignore Merge — append missing entries
_NOTES/ Skip — preserve existing
AGENTS/ Create missing parts only
This allows safe re-runs on existing projects to add agentic structure.
- Create Directory Structure
<project-name>/ ├── README.md ├── CHANGELOG.md ├── LICENSE ├── .gitignore ├── _NOTES/ │ └── .gitkeep └── AGENTS/ └── claude/ ├── CONTEXT.md ├── TODO.md ├── DECISIONS.md └── SESSION-LOG/
- Populate Files
Use templates from assets/ folder, substituting:
-
{{PROJECT_NAME}} — Project name
-
{{DESCRIPTION}} — Project description
-
{{DATE}} — Current date (YYYY-MM-DD)
-
{{YEAR}} — Current year
-
{{CATEGORY}} — Project category
See references/project-types.md for type-specific variations.
- Confirm Completion
Report to user:
-
Full path created
-
Files generated
-
Suggested next steps
Project Types
Type Additional Structure Use When
general
Base structure only Default, documentation
code-python
- src/ , tests/ , pyproject.toml
Python projects
code-node
- src/ , package.json
Node.js projects
3d-print
- models/ , images/
3D printing projects
research
- data/ , notebooks/
Research/data projects
See references/project-types.md for complete details.
Template Assets
File Source
README.md assets/README.template.md
CHANGELOG.md assets/CHANGELOG.template.md
LICENSE (MIT) assets/LICENSE-MIT.txt
LICENSE (Apache) assets/LICENSE-Apache2.txt
.gitignore assets/gitignore-general.txt
CONTEXT.md assets/CONTEXT.template.md
TODO.md assets/TODO.template.md
DECISIONS.md assets/DECISIONS.template.md
Integration with wrap-session
This skill creates the structure that /wrap-session writes to:
Init Creates Wrap-Session Updates
README.md (template) README.md (with progress)
CHANGELOG.md ([Unreleased]) CHANGELOG.md (with changes)
CONTEXT.md (initial state) CONTEXT.md (current state)
TODO.md (empty) TODO.md (with tasks)
SESSION-LOG/ (empty) SESSION-LOG/*.md