diff --git a/docs/CREATE-PLAN.md b/docs/CREATE-PLAN.md index 2d6442c..8dd86c3 100644 --- a/docs/CREATE-PLAN.md +++ b/docs/CREATE-PLAN.md @@ -12,7 +12,7 @@ Create structured implementation plans with milestone and story tracking, and op - `superpowers:writing-plans` - For Codex, native skill discovery must be configured: - `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills` -- For Cursor, skills must be installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) +- For Cursor, skills must be installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global) If dependencies are missing, stop and return: @@ -57,18 +57,18 @@ cp -R skills/create-plan/opencode/* ~/.config/opencode/skills/create-plan/ ### Cursor -Copy into the repo-local `.cursor/rules/` directory (where the Cursor Agent CLI discovers skills): +Copy into the repo-local `.cursor/skills/` directory (where the Cursor Agent CLI discovers skills): ```bash -mkdir -p .cursor/rules/create-plan -cp -R skills/create-plan/cursor/* .cursor/rules/create-plan/ +mkdir -p .cursor/skills/create-plan +cp -R skills/create-plan/cursor/* .cursor/skills/create-plan/ ``` -Or install globally (loaded via `~/.cursor/rules/`): +Or install globally (loaded via `~/.cursor/skills/`): ```bash -mkdir -p ~/.cursor/rules/create-plan -cp -R skills/create-plan/cursor/* ~/.cursor/rules/create-plan/ +mkdir -p ~/.cursor/skills/create-plan +cp -R skills/create-plan/cursor/* ~/.cursor/skills/create-plan/ ``` ## Verify Installation @@ -77,7 +77,7 @@ cp -R skills/create-plan/cursor/* ~/.cursor/rules/create-plan/ test -f ~/.codex/skills/create-plan/SKILL.md || true test -f ~/.claude/skills/create-plan/SKILL.md || true test -f ~/.config/opencode/skills/create-plan/SKILL.md || true -test -f .cursor/rules/create-plan/SKILL.md || test -f ~/.cursor/rules/create-plan/SKILL.md || true +test -f .cursor/skills/create-plan/SKILL.md || test -f ~/.cursor/skills/create-plan/SKILL.md || true ``` Verify Superpowers dependencies exist in your agent skills root: @@ -88,8 +88,8 @@ Verify Superpowers dependencies exist in your agent skills root: - Claude Code: `~/.claude/skills/superpowers/writing-plans/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/brainstorming/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/writing-plans/SKILL.md` -- Cursor: `.cursor/rules/superpowers/brainstorming/SKILL.md` or `~/.cursor/rules/superpowers/brainstorming/SKILL.md` -- Cursor: `.cursor/rules/superpowers/writing-plans/SKILL.md` or `~/.cursor/rules/superpowers/writing-plans/SKILL.md` +- Cursor: `.cursor/skills/superpowers/brainstorming/SKILL.md` or `~/.cursor/skills/superpowers/brainstorming/SKILL.md` +- Cursor: `.cursor/skills/superpowers/writing-plans/SKILL.md` or `~/.cursor/skills/superpowers/writing-plans/SKILL.md` ## Key Behavior @@ -177,7 +177,7 @@ All plan templates now include guardrail sections that enforce: ### Cursor -- Must use workspace discovery from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). +- Must use workspace discovery from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). - Must announce skill usage explicitly before invocation. - Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively. - Must not use `--force` or `--mode=agent` for review (reviewer should never write files). diff --git a/docs/IMPLEMENT-PLAN.md b/docs/IMPLEMENT-PLAN.md index 6d0c908..f6a10ab 100644 --- a/docs/IMPLEMENT-PLAN.md +++ b/docs/IMPLEMENT-PLAN.md @@ -19,7 +19,7 @@ Execute an existing plan (created by `create-plan`) in an isolated git worktree, - `superpowers:finishing-a-development-branch` - For Codex, native skill discovery must be configured: - `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills` -- For Cursor, skills must be installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) +- For Cursor, skills must be installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global) If dependencies are missing, stop and return: @@ -64,18 +64,18 @@ cp -R skills/implement-plan/opencode/* ~/.config/opencode/skills/implement-plan/ ### Cursor -Copy into the repo-local `.cursor/rules/` directory (where the Cursor Agent CLI discovers skills): +Copy into the repo-local `.cursor/skills/` directory (where the Cursor Agent CLI discovers skills): ```bash -mkdir -p .cursor/rules/implement-plan -cp -R skills/implement-plan/cursor/* .cursor/rules/implement-plan/ +mkdir -p .cursor/skills/implement-plan +cp -R skills/implement-plan/cursor/* .cursor/skills/implement-plan/ ``` -Or install globally (loaded via `~/.cursor/rules/`): +Or install globally (loaded via `~/.cursor/skills/`): ```bash -mkdir -p ~/.cursor/rules/implement-plan -cp -R skills/implement-plan/cursor/* ~/.cursor/rules/implement-plan/ +mkdir -p ~/.cursor/skills/implement-plan +cp -R skills/implement-plan/cursor/* ~/.cursor/skills/implement-plan/ ``` ## Verify Installation @@ -84,7 +84,7 @@ cp -R skills/implement-plan/cursor/* ~/.cursor/rules/implement-plan/ test -f ~/.codex/skills/implement-plan/SKILL.md || true test -f ~/.claude/skills/implement-plan/SKILL.md || true test -f ~/.config/opencode/skills/implement-plan/SKILL.md || true -test -f .cursor/rules/implement-plan/SKILL.md || test -f ~/.cursor/rules/implement-plan/SKILL.md || true +test -f .cursor/skills/implement-plan/SKILL.md || test -f ~/.cursor/skills/implement-plan/SKILL.md || true ``` Verify Superpowers execution dependencies exist in your agent skills root: @@ -101,10 +101,10 @@ Verify Superpowers execution dependencies exist in your agent skills root: - OpenCode: `~/.config/opencode/skills/superpowers/using-git-worktrees/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/finishing-a-development-branch/SKILL.md` -- Cursor: `.cursor/rules/superpowers/executing-plans/SKILL.md` or `~/.cursor/rules/superpowers/executing-plans/SKILL.md` -- Cursor: `.cursor/rules/superpowers/using-git-worktrees/SKILL.md` or `~/.cursor/rules/superpowers/using-git-worktrees/SKILL.md` -- Cursor: `.cursor/rules/superpowers/verification-before-completion/SKILL.md` or `~/.cursor/rules/superpowers/verification-before-completion/SKILL.md` -- Cursor: `.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md` or `~/.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md` +- Cursor: `.cursor/skills/superpowers/executing-plans/SKILL.md` or `~/.cursor/skills/superpowers/executing-plans/SKILL.md` +- Cursor: `.cursor/skills/superpowers/using-git-worktrees/SKILL.md` or `~/.cursor/skills/superpowers/using-git-worktrees/SKILL.md` +- Cursor: `.cursor/skills/superpowers/verification-before-completion/SKILL.md` or `~/.cursor/skills/superpowers/verification-before-completion/SKILL.md` +- Cursor: `.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md` or `~/.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md` ## Key Behavior @@ -163,7 +163,7 @@ After each milestone is implemented and verified, the skill sends it to a second ### Cursor -- Must use workspace discovery from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). +- Must use workspace discovery from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). - Must announce skill usage explicitly before invocation. - Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively. - Must not use `--force` or `--mode=agent` for review (reviewer should never write files). diff --git a/skills/create-plan/cursor/SKILL.md b/skills/create-plan/cursor/SKILL.md index cf80eb6..b2cbf65 100644 --- a/skills/create-plan/cursor/SKILL.md +++ b/skills/create-plan/cursor/SKILL.md @@ -15,7 +15,7 @@ This skill wraps the current Superpowers flow for the Cursor Agent CLI (`cursor- 3. Review the plan iteratively with a second model/provider 4. Persist a local execution package in `ai_plan/YYYY-MM-DD-/` -**Core principle:** Cursor Agent CLI discovers skills from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). It also reads `AGENTS.md` at the repo root for additional instructions. +**Core principle:** Cursor Agent CLI discovers skills from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). It also reads `AGENTS.md` at the repo root for additional instructions. ## Prerequisite Check (MANDATORY) @@ -23,7 +23,7 @@ Required: - Cursor Agent CLI: `cursor-agent --version` (install via `curl https://cursor.com/install -fsS | bash`). The binary is `cursor-agent` (installed to `~/.local/bin/`). Some environments alias it as `cursor agent` (subcommand of the Cursor IDE CLI) — both forms work, but this skill uses `cursor-agent` throughout. - `jq` (required only if using `cursor` as the reviewer CLI): `jq --version` (install via `brew install jq` or your package manager) - Superpowers repo: `https://github.com/obra/superpowers` -- Superpowers skills installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) +- Superpowers skills installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global) - `superpowers:brainstorming` - `superpowers:writing-plans` @@ -31,19 +31,19 @@ Verify before proceeding: ```bash cursor-agent --version -test -f .cursor/rules/superpowers/brainstorming/SKILL.md || test -f ~/.cursor/rules/superpowers/brainstorming/SKILL.md -test -f .cursor/rules/superpowers/writing-plans/SKILL.md || test -f ~/.cursor/rules/superpowers/writing-plans/SKILL.md +test -f .cursor/skills/superpowers/brainstorming/SKILL.md || test -f ~/.cursor/skills/superpowers/brainstorming/SKILL.md +test -f .cursor/skills/superpowers/writing-plans/SKILL.md || test -f ~/.cursor/skills/superpowers/writing-plans/SKILL.md # Only if using cursor as reviewer CLI: # jq --version ``` If any dependency is missing, stop and return: -`Missing dependency: Superpowers planning skills are required (superpowers:brainstorming, superpowers:writing-plans). Install from https://github.com/obra/superpowers and copy into .cursor/rules/ or ~/.cursor/rules/, then retry.` +`Missing dependency: Superpowers planning skills are required (superpowers:brainstorming, superpowers:writing-plans). Install from https://github.com/obra/superpowers and copy into .cursor/skills/ or ~/.cursor/skills/, then retry.` ## Required Skill Invocation Rules -- Invoke relevant skills through workspace discovery (`.cursor/rules/`). +- Invoke relevant skills through workspace discovery (`.cursor/skills/`). - Announce skill usage explicitly: - `I've read the [Skill Name] skill and I'm using it to [purpose].` - For skills with checklists, track checklist items explicitly in conversation. diff --git a/skills/create-plan/cursor/templates/continuation-runbook.md b/skills/create-plan/cursor/templates/continuation-runbook.md index a34dffd..d79734d 100644 --- a/skills/create-plan/cursor/templates/continuation-runbook.md +++ b/skills/create-plan/cursor/templates/continuation-runbook.md @@ -16,7 +16,7 @@ Do NOT reference planner-private files during implementation. ## Skill Workflow Guardrails -- Invoke relevant skills before action using workspace discovery (`.cursor/rules/`). +- Invoke relevant skills before action using workspace discovery (`.cursor/skills/`). - Announce which skill is being used and why. - If a checklist-driven skill applies, track checklist execution explicitly. diff --git a/skills/create-plan/cursor/templates/milestone-plan.md b/skills/create-plan/cursor/templates/milestone-plan.md index 5ab6619..b428a45 100644 --- a/skills/create-plan/cursor/templates/milestone-plan.md +++ b/skills/create-plan/cursor/templates/milestone-plan.md @@ -7,7 +7,7 @@ ## Planning Guardrails - This plan assumes design was validated before implementation planning. -- Skills are invoked via workspace discovery (`.cursor/rules/`). +- Skills are invoked via workspace discovery (`.cursor/skills/`). - Milestones require verification + local commits + explicit approval before proceeding. ## Context diff --git a/skills/implement-plan/cursor/SKILL.md b/skills/implement-plan/cursor/SKILL.md index 410c49a..7ff4f2a 100644 --- a/skills/implement-plan/cursor/SKILL.md +++ b/skills/implement-plan/cursor/SKILL.md @@ -16,7 +16,7 @@ This skill wraps the Superpowers execution flow for the Cursor Agent CLI (`curso 4. Review each milestone with a second model/provider 5. Commit approved milestones, merge to parent branch, and delete worktree -**Core principle:** Cursor Agent CLI discovers skills from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). It also reads `AGENTS.md` at the repo root for additional instructions. +**Core principle:** Cursor Agent CLI discovers skills from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). It also reads `AGENTS.md` at the repo root for additional instructions. ## Prerequisite Check (MANDATORY) @@ -28,7 +28,7 @@ Required: - `milestone-plan.md` exists in plan folder - `story-tracker.md` exists in plan folder - Git repo with worktree support: `git worktree list` -- Superpowers skills installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) +- Superpowers skills installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global) - Superpowers execution skills: - `superpowers:executing-plans` - `superpowers:using-git-worktrees` @@ -39,17 +39,17 @@ Verify before proceeding: ```bash cursor-agent --version -test -f .cursor/rules/superpowers/executing-plans/SKILL.md || test -f ~/.cursor/rules/superpowers/executing-plans/SKILL.md -test -f .cursor/rules/superpowers/using-git-worktrees/SKILL.md || test -f ~/.cursor/rules/superpowers/using-git-worktrees/SKILL.md -test -f .cursor/rules/superpowers/verification-before-completion/SKILL.md || test -f ~/.cursor/rules/superpowers/verification-before-completion/SKILL.md -test -f .cursor/rules/superpowers/finishing-a-development-branch/SKILL.md || test -f ~/.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md +test -f .cursor/skills/superpowers/executing-plans/SKILL.md || test -f ~/.cursor/skills/superpowers/executing-plans/SKILL.md +test -f .cursor/skills/superpowers/using-git-worktrees/SKILL.md || test -f ~/.cursor/skills/superpowers/using-git-worktrees/SKILL.md +test -f .cursor/skills/superpowers/verification-before-completion/SKILL.md || test -f ~/.cursor/skills/superpowers/verification-before-completion/SKILL.md +test -f .cursor/skills/superpowers/finishing-a-development-branch/SKILL.md || test -f ~/.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md # Only if using cursor as reviewer CLI: # jq --version ``` If any dependency is missing, stop and return: -`Missing dependency: [specific missing item]. Install from https://github.com/obra/superpowers and copy into .cursor/rules/ or ~/.cursor/rules/, then retry.` +`Missing dependency: [specific missing item]. Install from https://github.com/obra/superpowers and copy into .cursor/skills/ or ~/.cursor/skills/, then retry.` If no plan folder exists: @@ -57,7 +57,7 @@ If no plan folder exists: ## Required Skill Invocation Rules -- Invoke relevant skills through workspace discovery (`.cursor/rules/`). +- Invoke relevant skills through workspace discovery (`.cursor/skills/`). - Announce skill usage explicitly: - `I've read the [Skill Name] skill and I'm using it to [purpose].` - For skills with checklists, track checklist items explicitly in conversation.