project-help · diff

git:20260708.e42b71f to git:20260920.c148195

1 added, 1 removed. Audit A to A.

---

name: "project-help"

description: "Overview of project management commands"

---

## 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.

+ - `CLAUDE.md` references: read `AGENTS.md` first - it is the Codex entry point. Where it defers to `CLAUDE.md`, follow that pointer and `CLAUDE.md` is the rules; where it does not, `AGENTS.md` is. Where the repository has no `AGENTS.md`, read `CLAUDE.md`.

# 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.