@bonesofspring/ai-rules 0.1.37 → 0.1.40

package/presets/cursor/next/team/README.md

@@ -0,0 +1,106 @@
+# Agent team artifacts
+
+Каталог артефактов пайплайна «команда агентов» Cursor.
+
+## Layout
+
+```
+.cursor/team/
+  active-task.json              # { "slug": "current-task-slug" }
+  tasks/
+    <slug>/
+      pipeline.json             # Router: intent, steps, humanGates
+      status.json               # Current step and state machine
+      brief.md                  # Analyst: Definition of Ready
+      decomposition.md          # Analyst: task breakdown
+      debug-report.md           # Debugger (bugfix)
+      architecture.md           # Solution architect (spike / complex)
+```
+
+## Slug
+
+- kebab-case, derived from task title
+- max 48 characters
+- example: `order-history-date-filter`
+
+## pipeline.json schema
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "summary": "Add date filter to Order History",
+  "steps": [
+    { "agent": "task-analyst", "label": "Clarify and decompose" },
+    { "agent": "feature-developer", "label": "Implement" },
+    { "agent": "code-reviewer", "label": "Code review" },
+    { "agent": "qa-tester", "label": "Tests", "scope": "full" }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": []
+}
+```
+
+### intent values
+
+`feature` | `bugfix` | `review-only` | `test-only` | `refactor` | `spike` | `retro`
+
+## status.json schema (pipeline mode)
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "pipelineIndex": 0,
+  "currentAgent": "task-analyst",
+  "phase": "executing",
+  "state": "in_progress",
+  "awaitingHumanGate": false,
+  "updatedAt": "2026-05-29T12:00:00.000Z"
+}
+```
+
+### phase
+
+| Value | Description |
+|-------|-------------|
+| `executing` | Pipeline step in progress (preferred) |
+| `analysis` | Legacy: analyst phase |
+| `development` | Legacy: developer phase |
+| `review` | Legacy: review phase |
+| `testing` | Legacy: QA phase |
+| `done` | All steps complete |
+
+### state
+
+| Value | Description |
+|-------|-------------|
+| `in_progress` | Current step running |
+| `completed` | Current step finished |
+| `awaiting_approval` | Human gate; use `/task-continue` |
+| `changes_requested` | Reviewer requires fixes |
+| `approved` | Legacy: approved via continue |
+
+## Git
+
+Commit task artifacts if you want them to survive `ai-rules clean cursor`. Alternatively copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.
+
+## Workflow entry
+
+```bash
+/task <описание задачи>
+# при human gate после analyst:
+/task-continue <slug>
+# или
+/feature-continue <slug>
+# после пайплайна:
+/technical-retro <slug>
+```
+
+Legacy:
+
+```bash
+/feature-start <описание>
+/feature-continue <slug>
+```