Project Initialization Workflow

Scaffold projects with agentic coding structure for AI-assisted development.

Execution Steps

1. Determine Target Directory

• Default: Current working directory
• If user specifies a path, use that instead
• If directory doesn't exist, offer to create it

2. Gather Requirements

Required	Question	Default
	Project name?	Directory name
	Project type?	general
	License preference?	MIT
	Brief description?	"A new project"

Skip questions if context provides answers.

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. Confirm Before Creating

Show user:

• Target path
• Files to be created (noting any skipped)
• Project type selected

Wait for confirmation.

5. Create Directory Structure

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

6. Populate Files

Use templates from assets/ folder, substituting:

• {{PROJECT_NAME}} — Project name
• {{DESCRIPTION}} — Project description
• {{DATE}} — Current date (YYYY-MM-DD)
• {{YEAR}} — Current year

7. Add Type-Specific Files

Type	Additional Structure
general	Base structure only
code-python	+ src/, tests/, pyproject.toml
code-node	+ src/, package.json

See references/project-types.md for details.

8. Confirm Completion

Report:

• Full path created
• Files generated
• Suggested next steps

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

This skill creates structure compatible with /wrap-session:

Init Creates	Wrap-Session Updates
README.md	README.md (with progress)
CHANGELOG.md	CHANGELOG.md (with changes)
CONTEXT.md	CONTEXT.md (current state)
TODO.md	TODO.md (with tasks)
SESSION-LOG/	SESSION-LOG/*.md