product-on-purpose/init-project

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 |