@kurokeita/add-skill 2.6.1 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +43 -64
- package/dist/bin/cli.js +270 -478
- package/dist/skills/statusline-setup/.claude-plugin/plugin.json +1 -1
- package/dist/skills/statusline-setup/SKILL.md +48 -448
- package/dist/skills/statusline-setup/mod/hooks/register.tsx +93 -103
- package/dist/skills/statusline-setup/mod/tests/work.test.ts +28 -10
- package/dist/skills/statusline-setup/mod/types/index.d.ts +2 -1
- package/dist/skills/universalize-agents/reference/mapping.md +3 -2
- package/package.json +3 -3
- package/dist/agents/backend-specialist.md +0 -277
- package/dist/agents/code-archaeologist.md +0 -114
- package/dist/agents/database-architect.md +0 -238
- package/dist/agents/debugger.md +0 -231
- package/dist/agents/devops-engineer.md +0 -242
- package/dist/agents/documentation-writer.md +0 -104
- package/dist/agents/explorer-agent.md +0 -79
- package/dist/agents/frontend-specialist.md +0 -594
- package/dist/agents/game-developer.md +0 -162
- package/dist/agents/mobile-developer.md +0 -383
- package/dist/agents/orchestrator.md +0 -435
- package/dist/agents/penetration-tester.md +0 -188
- package/dist/agents/performance-optimizer.md +0 -191
- package/dist/agents/product-manager.md +0 -122
- package/dist/agents/product-owner.md +0 -106
- package/dist/agents/project-planner.md +0 -408
- package/dist/agents/qa-automation-engineer.md +0 -109
- package/dist/agents/security-auditor.md +0 -171
- package/dist/agents/test-engineer.md +0 -158
- package/dist/skills/agent-identifier/SKILL.md +0 -431
- package/dist/skills/agent-identifier/examples/agent-creation-prompt.md +0 -247
- package/dist/skills/agent-identifier/examples/complete-agent-examples.md +0 -432
- package/dist/skills/agent-identifier/references/agent-creation-system-prompt.md +0 -215
- package/dist/skills/agent-identifier/references/system-prompt-design.md +0 -419
- package/dist/skills/agent-identifier/references/triggering-examples.md +0 -508
- package/dist/skills/agent-identifier/scripts/validate-agent.sh +0 -217
- package/dist/skills/code-review-excellence/SKILL.md +0 -525
- package/dist/skills/component-refactoring/SKILL.md +0 -492
- package/dist/skills/component-refactoring/references/complexity-patterns.md +0 -493
- package/dist/skills/component-refactoring/references/component-splitting.md +0 -477
- package/dist/skills/component-refactoring/references/hook-extraction.md +0 -317
- package/dist/skills/context7-guidelines/SKILL.md +0 -31
- package/dist/skills/feature-design-assistant/SKILL.md +0 -371
- package/dist/skills/find-bugs/SKILL.md +0 -75
- package/dist/skills/frontend-design/SKILL.md +0 -45
- package/dist/skills/go-concurrency-patterns/SKILL.md +0 -657
- package/dist/skills/grill-me/SKILL.md +0 -9
- package/dist/skills/handoff/SKILL.md +0 -16
- package/dist/skills/koreader-plugin-development/SKILL.md +0 -141
- package/dist/skills/koreader-plugin-development/examples/2-example-patch.lua +0 -17
- package/dist/skills/koreader-plugin-development/examples/_meta.lua +0 -6
- package/dist/skills/koreader-plugin-development/examples/helloworld.lua +0 -36
- package/dist/skills/koreader-plugin-development/references/debugging.md +0 -92
- package/dist/skills/koreader-plugin-development/references/events-and-widgets.md +0 -102
- package/dist/skills/koreader-plugin-development/references/patches.md +0 -118
- package/dist/skills/koreader-plugin-development/references/plugin-anatomy.md +0 -97
- package/dist/skills/make-instruction/SKILL.md +0 -68
- package/dist/skills/make-prompt/SKILL.md +0 -70
- package/dist/skills/make-skill/SKILL.md +0 -147
- package/dist/skills/prd-to-tasks/SKILL.md +0 -164
- package/dist/skills/react-native-async-patterns/SKILL.md +0 -256
- package/dist/skills/react-native-performance/SKILL.md +0 -425
- package/dist/skills/react-native-testing/SKILL.md +0 -458
- package/dist/skills/react-native-zustand-patterns/SKILL.md +0 -343
- package/dist/skills/skill-creator/SKILL.md +0 -385
- package/dist/skills/skill-creator/scripts/init_skill.cjs +0 -235
- package/dist/skills/skill-creator/scripts/package_skill.cjs +0 -84
- package/dist/skills/skill-creator/scripts/validate_skill.cjs +0 -127
- package/dist/skills/skill-development/SKILL.md +0 -676
- package/dist/skills/skill-development/references/skill-creator-original.md +0 -210
- package/dist/skills/sql-optimization-patterns/SKILL.md +0 -509
- package/dist/skills/test-driven-development/SKILL.md +0 -114
- package/dist/skills/test-driven-development/deep-modules.md +0 -33
- package/dist/skills/test-driven-development/interface-design.md +0 -35
- package/dist/skills/test-driven-development/mocking.md +0 -68
- package/dist/skills/test-driven-development/refactoring.md +0 -10
- package/dist/skills/test-driven-development/tests.md +0 -61
- package/dist/skills/vercel-react-best-practices/AGENTS.md +0 -2410
- package/dist/skills/vercel-react-best-practices/SKILL.md +0 -127
- package/dist/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +0 -55
- package/dist/skills/vercel-react-best-practices/rules/advanced-use-latest.md +0 -49
- package/dist/skills/vercel-react-best-practices/rules/async-api-routes.md +0 -38
- package/dist/skills/vercel-react-best-practices/rules/async-defer-await.md +0 -80
- package/dist/skills/vercel-react-best-practices/rules/async-dependencies.md +0 -36
- package/dist/skills/vercel-react-best-practices/rules/async-parallel.md +0 -28
- package/dist/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +0 -99
- package/dist/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +0 -59
- package/dist/skills/vercel-react-best-practices/rules/bundle-conditional.md +0 -31
- package/dist/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +0 -49
- package/dist/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +0 -35
- package/dist/skills/vercel-react-best-practices/rules/bundle-preload.md +0 -50
- package/dist/skills/vercel-react-best-practices/rules/client-event-listeners.md +0 -74
- package/dist/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +0 -71
- package/dist/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +0 -48
- package/dist/skills/vercel-react-best-practices/rules/client-swr-dedup.md +0 -56
- package/dist/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +0 -82
- package/dist/skills/vercel-react-best-practices/rules/js-cache-function-results.md +0 -80
- package/dist/skills/vercel-react-best-practices/rules/js-cache-property-access.md +0 -28
- package/dist/skills/vercel-react-best-practices/rules/js-cache-storage.md +0 -70
- package/dist/skills/vercel-react-best-practices/rules/js-combine-iterations.md +0 -32
- package/dist/skills/vercel-react-best-practices/rules/js-early-exit.md +0 -50
- package/dist/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +0 -45
- package/dist/skills/vercel-react-best-practices/rules/js-index-maps.md +0 -37
- package/dist/skills/vercel-react-best-practices/rules/js-length-check-first.md +0 -50
- package/dist/skills/vercel-react-best-practices/rules/js-min-max-loop.md +0 -82
- package/dist/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +0 -24
- package/dist/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +0 -57
- package/dist/skills/vercel-react-best-practices/rules/rendering-activity.md +0 -26
- package/dist/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +0 -47
- package/dist/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +0 -40
- package/dist/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +0 -38
- package/dist/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +0 -46
- package/dist/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +0 -82
- package/dist/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +0 -28
- package/dist/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +0 -39
- package/dist/skills/vercel-react-best-practices/rules/rerender-dependencies.md +0 -45
- package/dist/skills/vercel-react-best-practices/rules/rerender-derived-state.md +0 -29
- package/dist/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +0 -74
- package/dist/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +0 -58
- package/dist/skills/vercel-react-best-practices/rules/rerender-memo.md +0 -44
- package/dist/skills/vercel-react-best-practices/rules/rerender-transitions.md +0 -40
- package/dist/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +0 -73
- package/dist/skills/vercel-react-best-practices/rules/server-cache-lru.md +0 -41
- package/dist/skills/vercel-react-best-practices/rules/server-cache-react.md +0 -76
- package/dist/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +0 -83
- package/dist/skills/vercel-react-best-practices/rules/server-serialization.md +0 -38
- package/dist/skills/web-design-guidelines/SKILL.md +0 -40
- package/dist/skills/workflow-patterns/SKILL.md +0 -623
- package/dist/skills/write-prd/SKILL.md +0 -162
- package/dist/workflows/brainstorm.md +0 -113
- package/dist/workflows/create.md +0 -60
- package/dist/workflows/debug.md +0 -107
- package/dist/workflows/deploy.md +0 -178
- package/dist/workflows/enhance.md +0 -64
- package/dist/workflows/github-pull-request-create.md +0 -134
- package/dist/workflows/orchestrate.md +0 -246
- package/dist/workflows/plan.md +0 -90
- package/dist/workflows/preview.md +0 -83
- package/dist/workflows/status.md +0 -87
- package/dist/workflows/test.md +0 -144
- package/dist/workflows/ui-ux-pro-max.md +0 -315
|
@@ -1,134 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Create a GitHub Pull Request for the current branch following project standards. Use when preparing a PR, generating PR title/body, validating branch state, and running the project's configured lint and type-check commands before `gh pr create`.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /pr - GitHub Pull Request
|
|
6
|
-
|
|
7
|
-
$ARGUMENTS
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Purpose
|
|
12
|
-
|
|
13
|
-
This command prepares and creates a GitHub Pull Request for the current branch.
|
|
14
|
-
|
|
15
|
-
It must validate the branch state, run the project's configured quality checks, generate a professional PR title/body, and only then create the PR.
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## Critical Rules
|
|
20
|
-
|
|
21
|
-
1. **Never create a PR from `main`**
|
|
22
|
-
2. **Never create a PR with no commits relative to `main`**
|
|
23
|
-
3. **Always run the project's configured lint command before creating the PR**
|
|
24
|
-
4. **Always run the project's configured type-check command before creating the PR**
|
|
25
|
-
5. **Stop and report the failure if linting or type checking fails**
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
## Validation Order
|
|
30
|
-
|
|
31
|
-
1. **Confirm branch state**
|
|
32
|
-
- Run `git branch --show-current`
|
|
33
|
-
- Refuse to continue if the current branch is `main`
|
|
34
|
-
|
|
35
|
-
2. **Confirm there is work to merge**
|
|
36
|
-
- Run `git log main..HEAD --oneline`
|
|
37
|
-
- Refuse to continue if there are no commits
|
|
38
|
-
|
|
39
|
-
3. **Discover project validation commands**
|
|
40
|
-
- Inspect project scripts and config first, such as `package.json`, `Makefile`, `justfile`, `cargo`, or other repo-standard task runners
|
|
41
|
-
- Prefer explicit project commands over guessed generic commands
|
|
42
|
-
|
|
43
|
-
4. **Run linting**
|
|
44
|
-
- Use the project's configured lint command
|
|
45
|
-
- Example for this repository: `pnpm run lint`
|
|
46
|
-
|
|
47
|
-
5. **Run type checking**
|
|
48
|
-
- Use the project's configured type-check command if one exists
|
|
49
|
-
- If no dedicated script exists but the project is TypeScript-based, run the established repo equivalent that performs type checking
|
|
50
|
-
- Example for this repository: `pnpm exec tsc --noEmit`
|
|
51
|
-
|
|
52
|
-
6. **Push branch**
|
|
53
|
-
- Run `git push -u origin $(git branch --show-current)` after validations pass
|
|
54
|
-
|
|
55
|
-
7. **Create PR**
|
|
56
|
-
- Run `gh pr create --base main --title "<title>" --body "<body>" {{args}}`
|
|
57
|
-
- Include `--draft` when the work is incomplete or requested in `$ARGUMENTS`
|
|
58
|
-
|
|
59
|
-
---
|
|
60
|
-
|
|
61
|
-
## PR Content Requirements
|
|
62
|
-
|
|
63
|
-
### Title
|
|
64
|
-
|
|
65
|
-
- Use a semantic title such as `feat: ...`, `fix: ...`, `chore: ...`, or `docs: ...`
|
|
66
|
-
- Match the actual change scope
|
|
67
|
-
|
|
68
|
-
### Body
|
|
69
|
-
|
|
70
|
-
Include these sections:
|
|
71
|
-
|
|
72
|
-
1. **Summary**
|
|
73
|
-
- Concise explanation of the purpose of the PR
|
|
74
|
-
|
|
75
|
-
2. **Key Changes**
|
|
76
|
-
- Bulleted list of the most important code changes
|
|
77
|
-
|
|
78
|
-
3. **Verification**
|
|
79
|
-
- Automated: list the lint and type-check commands that were run and whether they passed
|
|
80
|
-
- Manual: briefly describe any manual verification performed
|
|
81
|
-
|
|
82
|
-
4. **Related Tracks**
|
|
83
|
-
- Reference relevant track information from `conductor/tracks.md` when applicable
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
87
|
-
## Command Context
|
|
88
|
-
|
|
89
|
-
Gather this context before writing the PR:
|
|
90
|
-
|
|
91
|
-
- Current branch: `git branch --show-current`
|
|
92
|
-
- Commits relative to `main`: `git log main..HEAD --oneline`
|
|
93
|
-
- Diff summary: `git diff main..HEAD --stat`
|
|
94
|
-
|
|
95
|
-
Use that information to write a PR description that reflects the actual technical changes.
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## Output Format
|
|
100
|
-
|
|
101
|
-
```markdown
|
|
102
|
-
## PR Ready
|
|
103
|
-
|
|
104
|
-
### Title
|
|
105
|
-
feat: short, accurate summary
|
|
106
|
-
|
|
107
|
-
### Body
|
|
108
|
-
## Summary
|
|
109
|
-
...
|
|
110
|
-
|
|
111
|
-
## Key Changes
|
|
112
|
-
- ...
|
|
113
|
-
|
|
114
|
-
## Verification
|
|
115
|
-
- Automated: `pnpm run lint` ✅
|
|
116
|
-
- Automated: `pnpm exec tsc --noEmit` ✅
|
|
117
|
-
- Manual: ...
|
|
118
|
-
|
|
119
|
-
## Related Tracks
|
|
120
|
-
- ...
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
If validation fails, report the failing command and do not create the PR.
|
|
124
|
-
|
|
125
|
-
---
|
|
126
|
-
|
|
127
|
-
## Usage Examples
|
|
128
|
-
|
|
129
|
-
```text
|
|
130
|
-
/pr
|
|
131
|
-
/pr --draft
|
|
132
|
-
/pr --draft --assignee @me
|
|
133
|
-
/pr --label bug
|
|
134
|
-
```
|
|
@@ -1,246 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Coordinate multiple agents for complex tasks. Use for multi-perspective analysis, comprehensive reviews, or tasks requiring different domain expertise.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# Multi-Agent Orchestration
|
|
6
|
-
|
|
7
|
-
You are now in **ORCHESTRATION MODE**. Your task: coordinate specialized agents to solve this complex problem.
|
|
8
|
-
|
|
9
|
-
## Task to Orchestrate
|
|
10
|
-
|
|
11
|
-
$ARGUMENTS
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## 🔴 CRITICAL: Minimum Agent Requirement
|
|
16
|
-
|
|
17
|
-
> ⚠️ **ORCHESTRATION = MINIMUM 3 DIFFERENT AGENTS**
|
|
18
|
-
>
|
|
19
|
-
> If you use fewer than 3 agents, you are NOT orchestrating - you're just delegating.
|
|
20
|
-
>
|
|
21
|
-
> **Validation before completion:**
|
|
22
|
-
>
|
|
23
|
-
> - Count invoked agents
|
|
24
|
-
> - If `agent_count < 3` → STOP and invoke more agents
|
|
25
|
-
> - Single agent = FAILURE of orchestration
|
|
26
|
-
|
|
27
|
-
### Agent Selection Matrix
|
|
28
|
-
|
|
29
|
-
| Task Type | REQUIRED Agents (minimum) |
|
|
30
|
-
|-----------|---------------------------|
|
|
31
|
-
| **Web App** | frontend-specialist, backend-specialist, test-engineer |
|
|
32
|
-
| **API** | backend-specialist, security-auditor, test-engineer |
|
|
33
|
-
| **UI/Design** | frontend-specialist, seo-specialist, performance-optimizer |
|
|
34
|
-
| **Database** | database-architect, backend-specialist, security-auditor |
|
|
35
|
-
| **Full Stack** | project-planner, frontend-specialist, backend-specialist, devops-engineer |
|
|
36
|
-
| **Debug** | debugger, explorer-agent, test-engineer |
|
|
37
|
-
| **Security** | security-auditor, penetration-tester, devops-engineer |
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
## Pre-Flight: Mode Check
|
|
42
|
-
|
|
43
|
-
| Current Mode | Task Type | Action |
|
|
44
|
-
|--------------|-----------|--------|
|
|
45
|
-
| **plan** | Any | ✅ Proceed with planning-first approach |
|
|
46
|
-
| **edit** | Simple execution | ✅ Proceed directly |
|
|
47
|
-
| **edit** | Complex/multi-file | ⚠️ Ask: "This task requires planning. Switch to plan mode?" |
|
|
48
|
-
| **ask** | Any | ⚠️ Ask: "Ready to orchestrate. Switch to edit or plan mode?" |
|
|
49
|
-
|
|
50
|
-
---
|
|
51
|
-
|
|
52
|
-
## 🔴 STRICT 2-PHASE ORCHESTRATION
|
|
53
|
-
|
|
54
|
-
### PHASE 1: PLANNING (Sequential - NO parallel agents)
|
|
55
|
-
|
|
56
|
-
| Step | Agent | Action |
|
|
57
|
-
|------|-------|--------|
|
|
58
|
-
| 1 | `project-planner` | Create docs/PLAN.md |
|
|
59
|
-
| 2 | (optional) `explorer-agent` | Codebase discovery if needed |
|
|
60
|
-
|
|
61
|
-
> 🔴 **NO OTHER AGENTS during planning!** Only project-planner and explorer-agent.
|
|
62
|
-
|
|
63
|
-
### ⏸️ CHECKPOINT: User Approval
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
After PLAN.md is complete, ASK:
|
|
67
|
-
|
|
68
|
-
"✅ Plan oluşturuldu: docs/PLAN.md
|
|
69
|
-
|
|
70
|
-
Onaylıyor musunuz? (Y/N)
|
|
71
|
-
- Y: Implementation başlatılır
|
|
72
|
-
- N: Planı düzeltirim"
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
> 🔴 **DO NOT proceed to Phase 2 without explicit user approval!**
|
|
76
|
-
|
|
77
|
-
### PHASE 2: IMPLEMENTATION (Parallel agents after approval)
|
|
78
|
-
|
|
79
|
-
| Parallel Group | Agents |
|
|
80
|
-
|----------------|--------|
|
|
81
|
-
| Foundation | `database-architect`, `security-auditor` |
|
|
82
|
-
| Core | `backend-specialist`, `frontend-specialist` |
|
|
83
|
-
| Polish | `test-engineer`, `devops-engineer` |
|
|
84
|
-
|
|
85
|
-
> ✅ After user approval, invoke multiple agents in PARALLEL.
|
|
86
|
-
|
|
87
|
-
## Available Agents (17 total)
|
|
88
|
-
|
|
89
|
-
| Agent | Domain | Use When |
|
|
90
|
-
|-------|--------|----------|
|
|
91
|
-
| `project-planner` | Planning | Task breakdown, PLAN.md |
|
|
92
|
-
| `explorer-agent` | Discovery | Codebase mapping |
|
|
93
|
-
| `frontend-specialist` | UI/UX | React, Vue, CSS, HTML |
|
|
94
|
-
| `backend-specialist` | Server | API, Node.js, Python |
|
|
95
|
-
| `database-architect` | Data | SQL, NoSQL, Schema |
|
|
96
|
-
| `security-auditor` | Security | Vulnerabilities, Auth |
|
|
97
|
-
| `penetration-tester` | Security | Active testing |
|
|
98
|
-
| `test-engineer` | Testing | Unit, E2E, Coverage |
|
|
99
|
-
| `devops-engineer` | Ops | CI/CD, Docker, Deploy |
|
|
100
|
-
| `mobile-developer` | Mobile | React Native, Flutter |
|
|
101
|
-
| `performance-optimizer` | Speed | Lighthouse, Profiling |
|
|
102
|
-
| `seo-specialist` | SEO | Meta, Schema, Rankings |
|
|
103
|
-
| `documentation-writer` | Docs | README, API docs |
|
|
104
|
-
| `debugger` | Debug | Error analysis |
|
|
105
|
-
| `game-developer` | Games | Unity, Godot |
|
|
106
|
-
| `orchestrator` | Meta | Coordination |
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## Orchestration Protocol
|
|
111
|
-
|
|
112
|
-
### Step 1: Analyze Task Domains
|
|
113
|
-
|
|
114
|
-
Identify ALL domains this task touches:
|
|
115
|
-
|
|
116
|
-
```
|
|
117
|
-
□ Security → security-auditor, penetration-tester
|
|
118
|
-
□ Backend/API → backend-specialist
|
|
119
|
-
□ Frontend/UI → frontend-specialist
|
|
120
|
-
□ Database → database-architect
|
|
121
|
-
□ Testing → test-engineer
|
|
122
|
-
□ DevOps → devops-engineer
|
|
123
|
-
□ Mobile → mobile-developer
|
|
124
|
-
□ Performance → performance-optimizer
|
|
125
|
-
□ SEO → seo-specialist
|
|
126
|
-
□ Planning → project-planner
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
### Step 2: Phase Detection
|
|
130
|
-
|
|
131
|
-
| If Plan Exists | Action |
|
|
132
|
-
|----------------|--------|
|
|
133
|
-
| NO `docs/PLAN.md` | → Go to PHASE 1 (planning only) |
|
|
134
|
-
| YES `docs/PLAN.md` + user approved | → Go to PHASE 2 (implementation) |
|
|
135
|
-
|
|
136
|
-
### Step 3: Execute Based on Phase
|
|
137
|
-
|
|
138
|
-
**PHASE 1 (Planning):**
|
|
139
|
-
|
|
140
|
-
```
|
|
141
|
-
Use the project-planner agent to create PLAN.md
|
|
142
|
-
→ STOP after plan is created
|
|
143
|
-
→ ASK user for approval
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
**PHASE 2 (Implementation - after approval):**
|
|
147
|
-
|
|
148
|
-
```
|
|
149
|
-
Invoke agents in PARALLEL:
|
|
150
|
-
Use the frontend-specialist agent to [task]
|
|
151
|
-
Use the backend-specialist agent to [task]
|
|
152
|
-
Use the test-engineer agent to [task]
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
**🔴 CRITICAL: Context Passing (MANDATORY)**
|
|
156
|
-
|
|
157
|
-
When invoking ANY subagent, you MUST include:
|
|
158
|
-
|
|
159
|
-
1. **Original User Request:** Full text of what user asked
|
|
160
|
-
2. **Decisions Made:** All user answers to Socratic questions
|
|
161
|
-
3. **Previous Agent Work:** Summary of what previous agents did
|
|
162
|
-
4. **Current Plan State:** If plan files exist in workspace, include them
|
|
163
|
-
|
|
164
|
-
**Example with FULL context:**
|
|
165
|
-
|
|
166
|
-
```
|
|
167
|
-
Use the project-planner agent to create PLAN.md:
|
|
168
|
-
|
|
169
|
-
**CONTEXT:**
|
|
170
|
-
- User Request: "Öğrenciler için sosyal platform, mock data ile"
|
|
171
|
-
- Decisions: Tech=Vue 3, Layout=Grid Widget, Auth=Mock, Design=Genç Dinamik
|
|
172
|
-
- Previous Work: Orchestrator asked 6 questions, user chose all options
|
|
173
|
-
- Current Plan: playful-roaming-dream.md exists in workspace with initial structure
|
|
174
|
-
|
|
175
|
-
**TASK:** Create detailed PLAN.md based on ABOVE decisions. Do NOT infer from folder name.
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
> ⚠️ **VIOLATION:** Invoking subagent without full context = subagent will make wrong assumptions!
|
|
179
|
-
|
|
180
|
-
### Step 4: Verification (MANDATORY)
|
|
181
|
-
|
|
182
|
-
The LAST agent must run appropriate verification scripts:
|
|
183
|
-
|
|
184
|
-
```bash
|
|
185
|
-
python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
|
|
186
|
-
python .agent/skills/lint-and-validate/scripts/lint_runner.py .
|
|
187
|
-
```
|
|
188
|
-
|
|
189
|
-
### Step 5: Synthesize Results
|
|
190
|
-
|
|
191
|
-
Combine all agent outputs into unified report.
|
|
192
|
-
|
|
193
|
-
---
|
|
194
|
-
|
|
195
|
-
## Output Format
|
|
196
|
-
|
|
197
|
-
```markdown
|
|
198
|
-
## 🎼 Orchestration Report
|
|
199
|
-
|
|
200
|
-
### Task
|
|
201
|
-
[Original task summary]
|
|
202
|
-
|
|
203
|
-
### Mode
|
|
204
|
-
[Current Antigravity Agent mode: plan/edit/ask]
|
|
205
|
-
|
|
206
|
-
### Agents Invoked (MINIMUM 3)
|
|
207
|
-
| # | Agent | Focus Area | Status |
|
|
208
|
-
|---|-------|------------|--------|
|
|
209
|
-
| 1 | project-planner | Task breakdown | ✅ |
|
|
210
|
-
| 2 | frontend-specialist | UI implementation | ✅ |
|
|
211
|
-
| 3 | test-engineer | Verification scripts | ✅ |
|
|
212
|
-
|
|
213
|
-
### Verification Scripts Executed
|
|
214
|
-
- [x] security_scan.py → Pass/Fail
|
|
215
|
-
- [x] lint_runner.py → Pass/Fail
|
|
216
|
-
|
|
217
|
-
### Key Findings
|
|
218
|
-
1. **[Agent 1]**: Finding
|
|
219
|
-
2. **[Agent 2]**: Finding
|
|
220
|
-
3. **[Agent 3]**: Finding
|
|
221
|
-
|
|
222
|
-
### Deliverables
|
|
223
|
-
- [ ] PLAN.md created
|
|
224
|
-
- [ ] Code implemented
|
|
225
|
-
- [ ] Tests passing
|
|
226
|
-
- [ ] Scripts verified
|
|
227
|
-
|
|
228
|
-
### Summary
|
|
229
|
-
[One paragraph synthesis of all agent work]
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
---
|
|
233
|
-
|
|
234
|
-
## 🔴 EXIT GATE
|
|
235
|
-
|
|
236
|
-
Before completing orchestration, verify:
|
|
237
|
-
|
|
238
|
-
1. ✅ **Agent Count:** `invoked_agents >= 3`
|
|
239
|
-
2. ✅ **Scripts Executed:** At least `security_scan.py` ran
|
|
240
|
-
3. ✅ **Report Generated:** Orchestration Report with all agents listed
|
|
241
|
-
|
|
242
|
-
> **If any check fails → DO NOT mark orchestration complete. Invoke more agents or run scripts.**
|
|
243
|
-
|
|
244
|
-
---
|
|
245
|
-
|
|
246
|
-
**Begin orchestration now. Select 3+ agents, execute sequentially, run verification scripts, synthesize results.**
|
package/dist/workflows/plan.md
DELETED
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Create project plan using project-planner agent. No code writing - only plan file generation.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /plan - Project Planning Mode
|
|
6
|
-
|
|
7
|
-
$ARGUMENTS
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## 🔴 CRITICAL RULES
|
|
12
|
-
|
|
13
|
-
1. **NO CODE WRITING** - This command creates plan file only
|
|
14
|
-
2. **Use project-planner agent** - NOT Antigravity Agent's native Plan mode
|
|
15
|
-
3. **Socratic Gate** - Ask clarifying questions before planning
|
|
16
|
-
4. **Dynamic Naming** - Plan file named based on task
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## Task
|
|
21
|
-
|
|
22
|
-
Use the `project-planner` agent with this context:
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
CONTEXT:
|
|
26
|
-
- User Request: $ARGUMENTS
|
|
27
|
-
- Mode: PLANNING ONLY (no code)
|
|
28
|
-
- Output: docs/PLAN-{task-slug}.md (dynamic naming)
|
|
29
|
-
|
|
30
|
-
NAMING RULES:
|
|
31
|
-
1. Extract 2-3 key words from request
|
|
32
|
-
2. Lowercase, hyphen-separated
|
|
33
|
-
3. Max 30 characters
|
|
34
|
-
4. Example: "e-commerce cart" → PLAN-ecommerce-cart.md
|
|
35
|
-
|
|
36
|
-
RULES:
|
|
37
|
-
1. Follow project-planner.md Phase -1 (Context Check)
|
|
38
|
-
2. Follow project-planner.md Phase 0 (Socratic Gate)
|
|
39
|
-
3. Create PLAN-{slug}.md with task breakdown
|
|
40
|
-
4. DO NOT write any code files
|
|
41
|
-
5. REPORT the exact file name created
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
---
|
|
45
|
-
|
|
46
|
-
## Expected Output
|
|
47
|
-
|
|
48
|
-
| Deliverable | Location |
|
|
49
|
-
|-------------|----------|
|
|
50
|
-
| Project Plan | `docs/PLAN-{task-slug}.md` |
|
|
51
|
-
| Task Breakdown | Inside plan file |
|
|
52
|
-
| Agent Assignments | Inside plan file |
|
|
53
|
-
| Verification Checklist | Phase X in plan file |
|
|
54
|
-
|
|
55
|
-
---
|
|
56
|
-
|
|
57
|
-
## After Planning
|
|
58
|
-
|
|
59
|
-
Tell user:
|
|
60
|
-
|
|
61
|
-
```
|
|
62
|
-
[OK] Plan created: docs/PLAN-{slug}.md
|
|
63
|
-
|
|
64
|
-
Next steps:
|
|
65
|
-
- Review the plan
|
|
66
|
-
- Run `/create` to start implementation
|
|
67
|
-
- Or modify plan manually
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
72
|
-
## Naming Examples
|
|
73
|
-
|
|
74
|
-
| Request | Plan File |
|
|
75
|
-
|---------|-----------|
|
|
76
|
-
| `/plan e-commerce site with cart` | `docs/PLAN-ecommerce-cart.md` |
|
|
77
|
-
| `/plan mobile app for fitness` | `docs/PLAN-fitness-app.md` |
|
|
78
|
-
| `/plan add dark mode feature` | `docs/PLAN-dark-mode.md` |
|
|
79
|
-
| `/plan fix authentication bug` | `docs/PLAN-auth-fix.md` |
|
|
80
|
-
| `/plan SaaS dashboard` | `docs/PLAN-saas-dashboard.md` |
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## Usage
|
|
85
|
-
|
|
86
|
-
```
|
|
87
|
-
/plan e-commerce site with cart
|
|
88
|
-
/plan mobile app for fitness tracking
|
|
89
|
-
/plan SaaS dashboard with analytics
|
|
90
|
-
```
|
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Preview server start, stop, and status check. Local development server management.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /preview - Preview Management
|
|
6
|
-
|
|
7
|
-
$ARGUMENTS
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Task
|
|
12
|
-
|
|
13
|
-
Manage preview server: start, stop, status check.
|
|
14
|
-
|
|
15
|
-
### Commands
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
/preview - Show current status
|
|
19
|
-
/preview start - Start server
|
|
20
|
-
/preview stop - Stop server
|
|
21
|
-
/preview restart - Restart
|
|
22
|
-
/preview check - Health check
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## Usage Examples
|
|
28
|
-
|
|
29
|
-
### Start Server
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
/preview start
|
|
33
|
-
|
|
34
|
-
Response:
|
|
35
|
-
🚀 Starting preview...
|
|
36
|
-
Port: 3000
|
|
37
|
-
Type: Next.js
|
|
38
|
-
|
|
39
|
-
✅ Preview ready!
|
|
40
|
-
URL: http://localhost:3000
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Status Check
|
|
44
|
-
|
|
45
|
-
```
|
|
46
|
-
/preview
|
|
47
|
-
|
|
48
|
-
Response:
|
|
49
|
-
=== Preview Status ===
|
|
50
|
-
|
|
51
|
-
🌐 URL: http://localhost:3000
|
|
52
|
-
📁 Project: C:/projects/my-app
|
|
53
|
-
🏷️ Type: nextjs
|
|
54
|
-
💚 Health: OK
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
### Port Conflict
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
/preview start
|
|
61
|
-
|
|
62
|
-
Response:
|
|
63
|
-
⚠️ Port 3000 is in use.
|
|
64
|
-
|
|
65
|
-
Options:
|
|
66
|
-
1. Start on port 3001
|
|
67
|
-
2. Close app on 3000
|
|
68
|
-
3. Specify different port
|
|
69
|
-
|
|
70
|
-
Which one? (default: 1)
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
75
|
-
## Technical
|
|
76
|
-
|
|
77
|
-
Auto preview uses `auto_preview.py` script:
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
python .agent/scripts/auto_preview.py start [port]
|
|
81
|
-
python .agent/scripts/auto_preview.py stop
|
|
82
|
-
python .agent/scripts/auto_preview.py status
|
|
83
|
-
```
|
package/dist/workflows/status.md
DELETED
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Display agent and project status. Progress tracking and status board.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# /status - Show Status
|
|
6
|
-
|
|
7
|
-
$ARGUMENTS
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Task
|
|
12
|
-
|
|
13
|
-
Show current project and agent status.
|
|
14
|
-
|
|
15
|
-
### What It Shows
|
|
16
|
-
|
|
17
|
-
1. **Project Info**
|
|
18
|
-
- Project name and path
|
|
19
|
-
- Tech stack
|
|
20
|
-
- Current features
|
|
21
|
-
|
|
22
|
-
2. **Agent Status Board**
|
|
23
|
-
- Which agents are running
|
|
24
|
-
- Which tasks are completed
|
|
25
|
-
- Pending work
|
|
26
|
-
|
|
27
|
-
3. **File Statistics**
|
|
28
|
-
- Files created count
|
|
29
|
-
- Files modified count
|
|
30
|
-
|
|
31
|
-
4. **Preview Status**
|
|
32
|
-
- Is server running
|
|
33
|
-
- URL
|
|
34
|
-
- Health check
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## Example Output
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
=== Project Status ===
|
|
42
|
-
|
|
43
|
-
📁 Project: my-ecommerce
|
|
44
|
-
📂 Path: C:/projects/my-ecommerce
|
|
45
|
-
🏷️ Type: nextjs-ecommerce
|
|
46
|
-
📊 Status: active
|
|
47
|
-
|
|
48
|
-
🔧 Tech Stack:
|
|
49
|
-
Framework: next.js
|
|
50
|
-
Database: postgresql
|
|
51
|
-
Auth: clerk
|
|
52
|
-
Payment: stripe
|
|
53
|
-
|
|
54
|
-
✅ Features (5):
|
|
55
|
-
• product-listing
|
|
56
|
-
• cart
|
|
57
|
-
• checkout
|
|
58
|
-
• user-auth
|
|
59
|
-
• order-history
|
|
60
|
-
|
|
61
|
-
⏳ Pending (2):
|
|
62
|
-
• admin-panel
|
|
63
|
-
• email-notifications
|
|
64
|
-
|
|
65
|
-
📄 Files: 73 created, 12 modified
|
|
66
|
-
|
|
67
|
-
=== Agent Status ===
|
|
68
|
-
|
|
69
|
-
✅ database-architect → Completed
|
|
70
|
-
✅ backend-specialist → Completed
|
|
71
|
-
🔄 frontend-specialist → Dashboard components (60%)
|
|
72
|
-
⏳ test-engineer → Waiting
|
|
73
|
-
|
|
74
|
-
=== Preview ===
|
|
75
|
-
|
|
76
|
-
🌐 URL: http://localhost:3000
|
|
77
|
-
💚 Health: OK
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
## Technical
|
|
83
|
-
|
|
84
|
-
Status uses these scripts:
|
|
85
|
-
|
|
86
|
-
- `python .agent/scripts/session_manager.py status`
|
|
87
|
-
- `python .agent/scripts/auto_preview.py status`
|