JPKB Project Initialization Workflow

Scaffold new projects in the JPKB repository with standardized documentation artifacts.

Execution Steps

1. 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.

2. 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.

3. 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.

4. Create Directory Structure

<project-name>/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
├── _NOTES/
│   └── .gitkeep
└── AGENTS/
    └── claude/
        ├── CONTEXT.md
        ├── TODO.md
        ├── DECISIONS.md
        └── SESSION-LOG/

5. 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.

6. 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