@bonesofspring/ai-rules 0.2.3 → 0.2.5

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.
Files changed (69) hide show
  1. package/CHANGELOG.md +2 -0
  2. package/README.md +4 -3
  3. package/bin/cli.js +29 -3
  4. package/package.json +1 -1
  5. package/presets/claude/ios-swift/CLAUDE.md +1 -1
  6. package/presets/claude/ios-swift/MCP.md +14 -0
  7. package/presets/claude/ios-swift/README.md +2 -0
  8. package/presets/claude/ios-swift/agents/README.md +16 -2
  9. package/presets/claude/ios-swift/agents/migration-specialist.md +1 -1
  10. package/presets/claude/ios-swift/agents/performance-auditor.md +1 -1
  11. package/presets/claude/ios-swift/agents/security-reviewer.md +1 -1
  12. package/presets/claude/ios-swift/agents/solution-architect.md +1 -1
  13. package/presets/claude/ios-swift/agents/task-router.md +10 -1
  14. package/presets/claude/ios-swift/commands/feature-start.md +1 -1
  15. package/presets/claude/ios-swift/commands/task.md +1 -1
  16. package/presets/claude/ios-swift/mcp.json +12 -0
  17. package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-orchestrator.md +9 -1
  18. package/presets/claude/ios-swift/team/fixtures/feature-full.json +8 -25
  19. package/presets/claude/ios-swift/team/fixtures/feature-light.json +5 -20
  20. package/presets/claude/next/CLAUDE.md +1 -1
  21. package/presets/claude/next/MCP.md +16 -0
  22. package/presets/claude/next/README.md +2 -0
  23. package/presets/claude/next/agents/README.md +38 -4
  24. package/presets/claude/next/agents/migration-specialist.md +1 -1
  25. package/presets/claude/next/agents/performance-auditor.md +1 -1
  26. package/presets/claude/next/agents/security-reviewer.md +1 -1
  27. package/presets/claude/next/agents/solution-architect.md +1 -1
  28. package/presets/claude/next/agents/task-router.md +16 -2
  29. package/presets/claude/next/commands/feature-start.md +1 -1
  30. package/presets/claude/next/commands/task.md +1 -1
  31. package/presets/claude/next/hooks/chain-team-phases.sh +2 -2
  32. package/presets/claude/next/mcp.json +20 -0
  33. package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md +16 -2
  34. package/presets/claude/next/team/fixtures/feature-full.json +4 -2
  35. package/presets/claude/next/team/fixtures/feature-light.json +2 -2
  36. package/presets/cursor/ios-swift/AGENTS.md +1 -1
  37. package/presets/cursor/ios-swift/MCP.md +16 -0
  38. package/presets/cursor/ios-swift/README.md +1 -0
  39. package/presets/cursor/ios-swift/agents/README.md +16 -2
  40. package/presets/cursor/ios-swift/agents/migration-specialist.md +1 -1
  41. package/presets/cursor/ios-swift/agents/performance-auditor.md +1 -1
  42. package/presets/cursor/ios-swift/agents/security-reviewer.md +1 -1
  43. package/presets/cursor/ios-swift/agents/solution-architect.md +1 -1
  44. package/presets/cursor/ios-swift/agents/task-router.md +10 -1
  45. package/presets/cursor/ios-swift/commands/feature-start.md +1 -1
  46. package/presets/cursor/ios-swift/commands/task.md +1 -1
  47. package/presets/cursor/ios-swift/mcp.json +11 -0
  48. package/presets/cursor/ios-swift/rules/agent-team-orchestrator.mdc +14 -1
  49. package/presets/cursor/ios-swift/team/README.md +4 -0
  50. package/presets/cursor/ios-swift/team/fixtures/feature-full.json +8 -25
  51. package/presets/cursor/ios-swift/team/fixtures/feature-light.json +6 -25
  52. package/presets/cursor/next/AGENTS.md +1 -1
  53. package/presets/cursor/next/MCP.md +16 -0
  54. package/presets/cursor/next/agents/README.md +39 -4
  55. package/presets/cursor/next/agents/migration-specialist.md +1 -1
  56. package/presets/cursor/next/agents/performance-auditor.md +1 -1
  57. package/presets/cursor/next/agents/playwright-test-generator.md +1 -1
  58. package/presets/cursor/next/agents/playwright-test-healer.md +1 -1
  59. package/presets/cursor/next/agents/security-reviewer.md +1 -1
  60. package/presets/cursor/next/agents/solution-architect.md +1 -1
  61. package/presets/cursor/next/agents/task-router.md +16 -2
  62. package/presets/cursor/next/commands/feature-start.md +1 -1
  63. package/presets/cursor/next/commands/task.md +1 -1
  64. package/presets/cursor/next/hooks/chain-team-phases.sh +2 -2
  65. package/presets/cursor/next/mcp.json +19 -0
  66. package/presets/cursor/next/rules/agent-team-orchestrator.mdc +16 -0
  67. package/presets/cursor/next/team/README.md +4 -0
  68. package/presets/cursor/next/team/fixtures/feature-full.json +4 -2
  69. package/presets/cursor/next/team/fixtures/feature-light.json +2 -2
@@ -0,0 +1,19 @@
1
+ {
2
+ "mcpServers": {
3
+ "context7": {
4
+ "command": "npx",
5
+ "args": ["-y", "@upstash/context7-mcp"]
6
+ },
7
+ "playwright": {
8
+ "command": "npx",
9
+ "args": ["-y", "@playwright/mcp@latest"]
10
+ },
11
+ "chrome-devtools": {
12
+ "command": "npx",
13
+ "args": ["-y", "chrome-devtools-mcp@latest"]
14
+ },
15
+ "figma": {
16
+ "url": "https://mcp.figma.com/mcp"
17
+ }
18
+ }
19
+ }
@@ -102,6 +102,7 @@ flowchart TD
102
102
  | `skipIf` | `debugger.fixed` / `ci-investigator.resolved` — hook skips step when artifact says fix applied |
103
103
  | `parallel: true` | `agent` is array — invoke **all** agents in one parent turn; each appends to `parallelCompleted` |
104
104
  | `scope` | e.g. `unit-in-dev`, `e2e-only` — passed to developer/qa |
105
+ | `model` | `cheap` \| `standard` \| `strong` — optional tier override (see below) |
105
106
 
106
107
  ## Rules (strict)
107
108
 
@@ -115,10 +116,25 @@ flowchart TD
115
116
  8. When all steps complete, suggest `/technical-retro <slug>`.
116
117
  9. If `autoChain: false` in pipeline, do not rely on hook — manual step only.
117
118
 
119
+ ## Team artifact I/O (Cursor Shell sandbox)
120
+
121
+ - Create/update `.cursor/team/tasks/<slug>/**` with the **Write** tool (parents are created automatically). Do **not** bootstrap slug dirs with Shell `mkdir -p` — default sandbox returns `Operation not permitted` (worse on macOS Desktop/Documents with TCC `com.apple.macl`).
122
+ - If Shell must touch team paths and fails with EPERM, retry with `required_permissions: ["all"]`. Prefer Write for artifacts.
123
+ - Prefer repo under `~/Projects` / `WebstormProjects` over `~/Desktop` when using agent team heavily.
124
+
118
125
  ## Invoking agents
119
126
 
120
127
  Use Task tool or `/agent-name`. Pass: slug, artifact paths, step `scope` if set.
121
128
 
129
+ ### Model when invoking (Task)
130
+
131
+ 1. Read `steps[i].model` if present; else use the agent’s frontmatter `model` (see `agents/README.md` matrix).
132
+ 2. Map abstract tiers:
133
+ - **`cheap`** → pass Task `model: "fast"` when the tool accepts it (or rely on agent `fast`).
134
+ - **`standard`** → omit Task `model` (frontmatter `inherit` / mid default).
135
+ - **`strong`** → **never** pass `fast`; rely on agent pin (`claude-opus-4-8[effort=high]`) or parent Max model. If Task allows an explicit model ID from the allowed list, prefer the strong agent’s frontmatter ID.
136
+ 3. Parallel steps: apply the step-level `model` to **each** agent in the array (or omit → each agent’s own frontmatter).
137
+
122
138
  After each agent completes, ensure `status.json` has `state: completed` (or `awaiting_approval` if gate applies).
123
139
 
124
140
  ## Legacy mode
@@ -100,6 +100,10 @@ Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `re
100
100
 
101
101
  Legacy: `/feature-start`, `/feature-continue`.
102
102
 
103
+ ## Creating task dirs
104
+
105
+ Bootstrap `<slug>/` by **writing** `pipeline.json` / `status.json` (Write tool). Do **not** use Shell `mkdir -p` — Cursor’s default sandbox returns `Operation not permitted` (especially for repos on macOS Desktop/Documents).
106
+
103
107
  ## Git
104
108
 
105
109
  Commit task artifacts if you want them to survive `ai-rules clean cursor`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
@@ -5,9 +5,11 @@
5
5
  "summary": "Multi-layer feature with e2e coverage",
6
6
  "steps": [
7
7
  { "agent": "task-analyst", "label": "Clarify and decompose" },
8
+ { "agent": "solution-architect", "label": "Design boundaries", "model": "strong" },
8
9
  { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
9
- { "agent": "build-verifier", "label": "Validation gate" },
10
- { "agent": "code-reviewer", "label": "Code review" },
10
+ { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" },
11
+ { "agent": "security-reviewer", "label": "Security review", "model": "strong" },
12
+ { "agent": "code-reviewer", "label": "Code review", "model": "cheap" },
11
13
  { "agent": "qa-tester", "label": "E2E", "scope": "e2e-only" }
12
14
  ],
13
15
  "humanGates": ["after:task-analyst"],
@@ -4,8 +4,8 @@
4
4
  "profile": "light",
5
5
  "summary": "Trivial single-file change with explicit AC",
6
6
  "steps": [
7
- { "agent": "feature-developer", "label": "Implement" },
8
- { "agent": "build-verifier", "label": "Validation gate" }
7
+ { "agent": "feature-developer", "label": "Implement", "model": "cheap" },
8
+ { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" }
9
9
  ],
10
10
  "humanGates": [],
11
11
  "autoChain": true,