project-help git:20260708.e42b71fA

Immutable. This exact content is served forever at /api/v1/blob/a17b025b6d1b37be.

---
name: "project-help"
description: "Overview of project management commands"
---
<!-- GENERATED by claude-power-pack - scripts/codex-skill-sync.py; edit .claude/commands/project/help.md instead -->

## Codex harness adaptations

Generated from a Claude Code command. Where the procedure references these Claude-only surfaces, adapt as follows:

- `CLAUDE.md` references: Codex reads `AGENTS.md`; treat them as the target repo's agent-context file.

# Project Commands

Commands for creating and managing projects.

## Commands

| Command | Description |
|---------|-------------|
| `/project-init <name>` | Full project scaffolding - zero to GitHub repo |
| `/project-next` | Scan issues and worktrees to recommend next steps |
| `/project-lite` | Quick project reference with minimal context |
| `/claude-md-lint` | Audit CLAUDE.md for CI/CD and troubleshooting directives |

## /project-init

One-command project setup that orchestrates:

1. Creates `~/Projects/<name>` with framework scaffold (Python/Node/Go/Rust)
2. Initializes git and pushes to a new GitHub repo
3. Generates Makefile from detected framework (`lib/cicd`)
4. Installs the CPP toolkit (commands + skills symlinks, secret-masking hook)
5. Delegates CLAUDE.md/skills/hooks scaffolding to native `/init`, then applies CPP
   CI/CD governance via `/claude-md-lint`
6. Initializes `.specify/` for spec-driven development
7. Optionally creates an initial feature spec

**Example:**
```
/project-init my-api
```

**Features:**
- Idempotent - safe to re-run if interrupted (completed steps are skipped)
- Framework-specific scaffolds with best-practice project structure
- Config scaffolding (CLAUDE.md, skills, hooks) delegated to native `/init`; CPP
  owns only the zero-to-GitHub-repo orchestration and the governance overlay
- Integrates with `/flow`, `/spec`, `/security`, and all CPP commands

## /project-next

Prioritized next-step report. Scans open issues in one batched call, maps worktrees, applies a blocked/in-flight verification gate, and recommends what to work on next. Compact by default; `--full` for the deep 5-tier analysis, `--brief` for a single top pick.

**Use when:** Unsure what to work on, need issue triage, or want cleanup suggestions.

## /project-lite

Lightweight project reference for quick orientation. Shows repo info, conventions, worktrees, and available commands with minimal context usage.

**Use when:** Starting a session, context is high, or you already know what to work on.