plastic-project-creating

Creating a Project

Precondition

An active intent must exist with enough context to define a project — at minimum: name/slug, path, and key decisions from ## Context > ### Decisions.

Workflow

1. Determine Project Identity

• Slug: derived from intent name (kebab-case, 2-4 words) or user-specified
• Path: from ~/.plastic/config.yml project_roots (first entry as default), or user-specified
• Confirm path with user before creation

2. Create Project Directory

mkdir -p <project_root>/<slug>
cd <project_root>/<slug>
git init

3. Run plastic-install --local

Invoke plastic-install --local in the project directory. This creates:

.plastic/
├── store/
├── INDEX.md
└── config.yml

4. Populate AGENTS.md

Create AGENTS.md in the project root from the skeleton in references/project-scaffolding.md ("AGENTS.md skeleton"): read it now and fill in the project name, governing intent IDs, decisions, and project-specific rules.

5. Create Tactical Mirror

Create the first intent in the project's store at ~/.plastic/projects/{slug}/store/ using the frontmatter, sections, and INDEX.md line in references/project-scaffolding.md ("Tactical mirror intent"), including the Hub multi-intent variant if there is more than one founding intent.

Directory: ~/.plastic/projects/{slug}/store/1--{slug}/ File: ~/.plastic/projects/{slug}/store/1--{slug}/1--{slug}.md

6. Register in projects.yml

Read ~/.plastic/projects.yml and add the entry shown in references/project-scaffolding.md ("projects.yml registration block"). For Hub-spawned projects, parent references the primary founding intent.

7. Provision the Project Store

The provision-project-store verb is the single source of truth for store creation. Run it after the project is registered in step 6 (the provisioner requires registration), and before the QMD step:

ruby ~/.plastic/scripts/provision-project-store <slug>

This ensures ~/.plastic/projects/<slug>/store/ exists with .gitkeep, and writes INDEX.md and project.yml only if missing. It is idempotent, so it is safe even when the tactical mirror in step 5 already created the store directory. Do not create the store with an inline mkdir; the provisioner is the only place a store is made. For a project that is already registered but store-less, use the plastic-store-provisioning skill instead.