diff --git a/README.md b/README.md index dcfe2ec..16d1e3c 100644 --- a/README.md +++ b/README.md @@ -35,17 +35,19 @@ node bin/antigravity-superpowers.js init --- -## What's New in v0.2.0 +## What's New in v0.3.0 | Feature | Description | | --- | --- | -| `validate` command | Run 78 automated checks on your `.agent` profile (files, skills, frontmatter, legacy patterns, AGENTS mapping) | +| 9 slash commands | `/brainstorm`, `/write-plan`, `/execute-plan`, `/debug`, `/tdd`, `/review`, `/verify`, `/finish-branch`, `/worktree` | +| Workflow format fix | Fixed workflow frontmatter to follow Antigravity convention (no `name:` field, numbered steps) | +| `add-azure-skills` | Integrate 192 Microsoft Azure skills with curated bundles | +| `validate` command | Run automated checks on your `.agent` profile (files, skills, workflows, frontmatter, legacy patterns, AGENTS mapping) | | `list` command | List all 13 bundled skills with names and descriptions | | `--version` / `-v` | Show CLI version | | `--dry-run` / `-n` | Preview files that would be copied without making changes | | `--backup` / `-b` | Backup existing `.agent` to `.agent-backup-` before overwrite | | 20 automated tests | Expanded from 3 to 20 tests covering CLI, init, and validate | -| Node >= 21 fix | Fixed `npm test` compatibility with newer Node.js versions | --- @@ -132,7 +134,7 @@ antigravity-superpowers init antigravity-superpowers init /path/to/project ``` -This copies the complete `.agent` profile (13 skills, 3 workflows, validation tests) into your project root. +This copies the complete `.agent` profile (13 skills, 9 workflows/slash commands, validation tests) into your project root. ### 2. Validate the profile @@ -174,7 +176,7 @@ Antigravity Superpowers — 13 skills available: antigravity-superpowers init --dry-run ``` -Shows all 43 files that would be copied, without making any changes. +Shows all 49 files that would be copied, without making any changes. ### 5. Update an existing profile @@ -274,7 +276,21 @@ Global options: | `using-superpowers` | Skill routing and session bootstrap | | `writing-skills` | Create new skills that follow the system's conventions | -Plus supporting infrastructure: 3 workflows, 1 reviewer agent, validation tests, and an `AGENTS.md` contract that ties it all together. +**9 slash commands** (workflows) — type `/` in Antigravity chat to invoke: + +| Command | Action | +| --- | --- | +| `/brainstorm` | Explore ideas before creative work | +| `/write-plan` | Create detailed implementation plan | +| `/execute-plan` | Execute plan step by step | +| `/debug` | Systematic debugging workflow | +| `/tdd` | Test-driven development | +| `/review` | Request structured code review | +| `/verify` | Verify work before claiming done | +| `/finish-branch` | Clean branch wrap-up | +| `/worktree` | Create isolated git worktree | + +Plus supporting infrastructure: 1 reviewer agent, validation tests, and an `AGENTS.md` contract that ties it all together. --- diff --git a/package.json b/package.json index 6144875..9ba620e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "antigravity-superpowers", - "version": "0.2.0", + "version": "0.3.0", "description": "CLI to initialize the Antigravity Superpowers .agent profile", "type": "module", "bin": { diff --git a/scripts/check-pack.mjs b/scripts/check-pack.mjs index f45779f..367c37a 100644 --- a/scripts/check-pack.mjs +++ b/scripts/check-pack.mjs @@ -30,6 +30,12 @@ const required = [ "templates/.agent/workflows/brainstorm.md", "templates/.agent/workflows/write-plan.md", "templates/.agent/workflows/execute-plan.md", + "templates/.agent/workflows/debug.md", + "templates/.agent/workflows/tdd.md", + "templates/.agent/workflows/review.md", + "templates/.agent/workflows/verify.md", + "templates/.agent/workflows/finish-branch.md", + "templates/.agent/workflows/worktree.md", "templates/.agent/agents/code-reviewer.md", "templates/.agent/tests/run-tests.sh", "templates/.agent/tests/check-antigravity-profile.sh", diff --git a/src/commands/validate.js b/src/commands/validate.js index 2a7e1ce..2fb95b0 100644 --- a/src/commands/validate.js +++ b/src/commands/validate.js @@ -36,6 +36,12 @@ const REQUIRED_FILES = [ "workflows/brainstorm.md", "workflows/write-plan.md", "workflows/execute-plan.md", + "workflows/debug.md", + "workflows/tdd.md", + "workflows/review.md", + "workflows/verify.md", + "workflows/finish-branch.md", + "workflows/worktree.md", "agents/code-reviewer.md", "tests/run-tests.sh", "tests/check-antigravity-profile.sh", @@ -150,6 +156,40 @@ export async function validateCommand(args, { cwd, stdout, stderr }) { else fail(`${skill} missing description field`); } + stdout.write("\nChecking workflow frontmatter...\n"); + const workflowFiles = [ + "brainstorm.md", + "write-plan.md", + "execute-plan.md", + "debug.md", + "tdd.md", + "review.md", + "verify.md", + "finish-branch.md", + "worktree.md", + ]; + for (const wf of workflowFiles) { + const wfPath = join(agentDir, "workflows", wf); + if (!(await exists(wfPath))) continue; + + const content = await readFile(wfPath, "utf8"); + const hasDelimiters = /^---$/m.test(content); + const hasDescription = /^description:\s*\S/m.test(content); + const hasName = /^name:\s*\S/m.test(content); + + if (hasDelimiters && hasDescription) { + pass(`Workflow ${wf} has valid frontmatter`); + } else { + fail(`Workflow ${wf} missing frontmatter or description`); + } + + if (hasName) { + fail(`Workflow ${wf} has 'name:' field (should use filename as command name)`); + } else { + pass(`Workflow ${wf} uses filename as command name`); + } + } + stdout.write("\nChecking for legacy patterns...\n"); const skillsDir = join(agentDir, "skills"); let allSkillContent = ""; diff --git a/templates/.agent/workflows/brainstorm.md b/templates/.agent/workflows/brainstorm.md index eaa1abc..bf028b9 100644 --- a/templates/.agent/workflows/brainstorm.md +++ b/templates/.agent/workflows/brainstorm.md @@ -1,6 +1,7 @@ --- -name: brainstorm -description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores requirements and design before implementation." +description: Brainstorm ideas before any creative work - explore requirements and design before implementation --- -Invoke the `.agent/skills/brainstorming/SKILL.md` workflow and follow it exactly as presented to you. +1. Read the skill file at `.agent/skills/brainstorming/SKILL.md` using view_file +2. Follow the brainstorming workflow exactly as described in the skill +3. Explore the user's intent, requirements, and design constraints before proposing any implementation diff --git a/templates/.agent/workflows/debug.md b/templates/.agent/workflows/debug.md new file mode 100644 index 0000000..21ef797 --- /dev/null +++ b/templates/.agent/workflows/debug.md @@ -0,0 +1,7 @@ +--- +description: Systematically debug a bug, test failure, or unexpected behavior +--- + +1. Read the skill file at `.agent/skills/systematic-debugging/SKILL.md` using view_file +2. Follow the debugging workflow exactly as described in the skill +3. Trace root cause with evidence before proposing any fix diff --git a/templates/.agent/workflows/execute-plan.md b/templates/.agent/workflows/execute-plan.md index b198a5f..9c8182e 100644 --- a/templates/.agent/workflows/execute-plan.md +++ b/templates/.agent/workflows/execute-plan.md @@ -1,6 +1,7 @@ --- -name: execute-plan -description: Execute plan in single-flow mode +description: Execute an implementation plan step by step in single-flow mode --- -Invoke the `.agent/skills/executing-plans/SKILL.md` workflow and follow it exactly as presented to you. +1. Read the skill file at `.agent/skills/executing-plans/SKILL.md` using view_file +2. Follow the execution workflow exactly as described in the skill +3. Execute the plan tasks sequentially with review gates between steps diff --git a/templates/.agent/workflows/finish-branch.md b/templates/.agent/workflows/finish-branch.md new file mode 100644 index 0000000..326b313 --- /dev/null +++ b/templates/.agent/workflows/finish-branch.md @@ -0,0 +1,7 @@ +--- +description: Finish a development branch - merge, PR, or cleanup options +--- + +1. Read the skill file at `.agent/skills/finishing-a-development-branch/SKILL.md` using view_file +2. Follow the branch completion workflow exactly as described in the skill +3. Present structured options for merge, PR, or cleanup diff --git a/templates/.agent/workflows/review.md b/templates/.agent/workflows/review.md new file mode 100644 index 0000000..0731169 --- /dev/null +++ b/templates/.agent/workflows/review.md @@ -0,0 +1,7 @@ +--- +description: Request a structured code review with checklist verification +--- + +1. Read the skill file at `.agent/skills/requesting-code-review/SKILL.md` using view_file +2. Follow the code review workflow exactly as described in the skill +3. Verify work meets requirements using structured checklists diff --git a/templates/.agent/workflows/tdd.md b/templates/.agent/workflows/tdd.md new file mode 100644 index 0000000..002f8e3 --- /dev/null +++ b/templates/.agent/workflows/tdd.md @@ -0,0 +1,7 @@ +--- +description: Test-driven development - write tests first, then implement +--- + +1. Read the skill file at `.agent/skills/test-driven-development/SKILL.md` using view_file +2. Follow the TDD workflow exactly as described in the skill +3. Write failing tests first, then implement code to make them pass diff --git a/templates/.agent/workflows/verify.md b/templates/.agent/workflows/verify.md new file mode 100644 index 0000000..b76a67b --- /dev/null +++ b/templates/.agent/workflows/verify.md @@ -0,0 +1,7 @@ +--- +description: Verify work is complete - run checks and confirm output before claiming done +--- + +1. Read the skill file at `.agent/skills/verification-before-completion/SKILL.md` using view_file +2. Follow the verification workflow exactly as described in the skill +3. Run all verification commands and confirm output before making any success claims diff --git a/templates/.agent/workflows/worktree.md b/templates/.agent/workflows/worktree.md new file mode 100644 index 0000000..ca94922 --- /dev/null +++ b/templates/.agent/workflows/worktree.md @@ -0,0 +1,7 @@ +--- +description: Create an isolated git worktree for feature work +--- + +1. Read the skill file at `.agent/skills/using-git-worktrees/SKILL.md` using view_file +2. Follow the worktree workflow exactly as described in the skill +3. Create isolated git worktree with smart directory selection and safety verification diff --git a/templates/.agent/workflows/write-plan.md b/templates/.agent/workflows/write-plan.md index bf16000..8e6c5bc 100644 --- a/templates/.agent/workflows/write-plan.md +++ b/templates/.agent/workflows/write-plan.md @@ -1,6 +1,7 @@ --- -name: write-plan -description: Create detailed implementation plan with bite-sized tasks +description: Create a detailed implementation plan with bite-sized tasks before coding --- -Invoke the `.agent/skills/writing-plans/SKILL.md` workflow and follow it exactly as presented to you. +1. Read the skill file at `.agent/skills/writing-plans/SKILL.md` using view_file +2. Follow the planning workflow exactly as described in the skill +3. Produce a step-by-step plan with clear, testable tasks