# pi-create

> Opinionated project scaffolder for pi.dev extensions with full pipeline integration.

## Installation

```bash
pi install npm:pi-create
```

## What It Does

pi-create scaffolds new pi.dev extension projects with pipeline tools pre-wired. It fills the gap where pi-extension-toolkit provides bare structural scaffolding only — pi-create adds pipeline integration (commit-lint, changelog, CI, release, readme, env-guard) out of the box.

### Template Variants

| Variant | Description | ~LOC |
|---------|-------------|------|
| **tool** | Single-tool extension (minimal) | 150 |
| **command** | Command-only extension (no tools) | 100 |
| **skill** | Full skill package (tools + commands) | 300 |
| **full** | Complete package with all pipeline tools pre-wired | 450 |

## Tools

### `scaffold_project`

Create a new pi.dev extension project from a template variant.

**Parameters:**
- `name` (string, required) — Project name (e.g. "pi-my-tool")
- `description` (string, required) — Short description
- `variant` (enum: tool|command|skill|full, required) — Template variant
- `features` (string[], optional) — Features to include

**Example:**
```
Use scaffold_project with name="pi-greet", description="A greeting extension", variant="tool"
```

### `scaffold_add`

Add components to an existing scaffolded project.

**Parameters:**
- `component` (enum: tool|command|skill|test|ci|readme, required) — Component type
- `name` (string, required) — Name for the new component

**Example:**
```
Use scaffold_add with component="tool", name="fetch_data"
```

### `scaffold_validate`

Validate a scaffolded pi.dev project.

**Parameters:**
- `projectPath` (string, optional) — Path to project (defaults to cwd)

**Example:**
```
Use scaffold_validate to check if the project is correctly scaffolded
```

## Pipeline Tools Pre-wired (full variant)

- **pi-commit-lint** — Conventional commit enforcement
- **pi-changelog** — Changelog generation
- **pi-ci** — GitHub Actions workflow
- **pi-release** — Release automation
- **pi-readme** — README template
- **pi-env-guard** — Environment validation

## Resources

- [npm](https://www.npmjs.com/package/pi-create)
- [GitHub](https://github.com/ZachDreamZ/pi-create)
- [pi.dev](https://pi.dev/packages/pi-create)

## License

MIT