its-magic 0.1.2-9 → 0.1.2

package/.cursor/commands/gsd-milestone-complete.md

@@ -1,24 +0,0 @@
----
-description: "GSD milestone complete: finalize milestone summary."
----
-
-# /gsd-milestone-complete
-
-## Subagents
-- release
-- curator
-
-## Inputs
-- `milestones/M0001/summary.md`
-- `handoffs/release_notes.md`
-
-## Outputs (artifacts)
-- Updated `milestones/M0001/summary.md`
-- Updated `docs/engineering/state.md`
-
-## Stop conditions
-- Decision gate triggered
-
-## Steps
-1. Finalize milestone summary.
-2. Confirm release notes and state.

package/.cursor/commands/gsd-milestone-start.md

@@ -1,26 +0,0 @@
----
-description: "GSD milestone start: create milestone tracking files."
----
-
-# /gsd-milestone-start
-
-## Subagents
-- tech-lead
-- curator
-
-## Inputs
-- Milestone name, goals, scope
-
-## Outputs (artifacts)
-- `milestones/M0001/milestone.json`
-- `milestones/M0001/phases.json`
-- `milestones/M0001/progress.md`
-- `milestones/M0001/summary.md`
-
-## Stop conditions
-- Decision gate triggered
-
-## Steps
-1. Define milestone goals and scope.
-2. List phases and intended outcomes.
-3. Initialize progress and summary.

package/.cursor/commands/gsd-pause.md

@@ -1,25 +0,0 @@
----
-description: "GSD pause: write checkpoint and resume brief."
----
-
-# /gsd-pause
-
-## Subagents
-- curator
-
-## Inputs
-- Current sprint progress and state
-
-## Outputs (artifacts)
-- `docs/engineering/state.md`
-- `sprints/S0001/progress.md`
-- `handoffs/resume_brief.md`
-
-## Stop conditions
-- Missing state or progress updates
-
-## Steps
-1. Write a short checkpoint of current work.
-2. Update sprint progress and state.
-3. Write a resume brief with next actions.
-

package/.cursor/commands/gsd-plan-verify.md

@@ -1,26 +0,0 @@
----
-description: "GSD plan verify: verify sprint tasks against acceptance."
----
-
-# /gsd-plan-verify
-
-## Subagents
-- tech-lead
-
-## Inputs
-- `sprints/S0001/tasks.md`
-- `docs/product/acceptance.md`
-- `docs/engineering/architecture.md`
-
-## Outputs (artifacts)
-- `sprints/S0001/plan-verify.json`
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Tasks do not cover acceptance criteria
-- Decision gate triggered
-
-## Steps
-1. Check each acceptance criterion against tasks.
-2. Record gaps and required changes in `plan-verify.json`.
-3. Update state and handoff if needed.

package/.cursor/commands/gsd-qa.md

@@ -1,28 +0,0 @@
----
-description: "GSD QA: test plan, findings, verify fixes."
----
-
-# /gsd-qa
-
-## Subagents
-- qa
-
-## Inputs
-- `handoffs/dev_to_qa.md`
-- `sprints/S0001/summary.md`
-
-## Outputs (artifacts)
-- `sprints/S0001/qa-findings.md`
-- `handoffs/qa_to_dev.md` (if issues)
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Critical defects require decision
-- Missing test plan coverage
-
-## Steps
-1. Define a test plan and run verification.
-2. Record findings and severity.
-3. Update state and handoff to dev if needed.
-4. Follow with `/gsd-verify-work` for user acceptance.
-

package/.cursor/commands/gsd-quick.md

@@ -1,24 +0,0 @@
----
-description: "GSD quick: execute a small task without full planning."
----
-
-# /gsd-quick
-
-## Subagents
-- dev
-
-## Inputs
-- Task description
-
-## Outputs (artifacts)
-- `sprints/quick/Q0001/task.json`
-- `sprints/quick/Q0001/summary.md`
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Decision gate triggered
-
-## Steps
-1. Define the task in `task.json`.
-2. Implement the change quickly.
-3. Write a short summary and update state.

package/.cursor/commands/gsd-refresh-context.md

@@ -1,26 +0,0 @@
----
-description: "GSD refresh context: compact state and decisions."
----
-
-# /gsd-refresh-context
-
-## Subagents
-- curator
-
-## Inputs
-- Current sprint artifacts
-- Decisions and handoffs
-
-## Outputs (artifacts)
-- `docs/engineering/state.md`
-- `docs/engineering/decisions.md`
-- `sprints/S0001/summary.md`
-
-## Stop conditions
-- Missing critical artifacts
-
-## Steps
-1. Compact state and decisions into a short context pack.
-2. Update sprint summary with current status.
-3. Ensure handoffs and state are consistent.
-

package/.cursor/commands/gsd-release.md

@@ -1,29 +0,0 @@
----
-description: "GSD release: prepare release notes and runbook updates."
----
-
-# /gsd-release
-
-## Subagents
-- release
-
-## Inputs
-- `sprints/S0001/summary.md`
-- `docs/engineering/runbook.md`
-
-## Outputs (artifacts)
-- `handoffs/release_notes.md`
-- `docs/engineering/runbook.md`
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Deploy command missing for requested environment
-- Decision gate triggered
-
-## Steps
-1. Write release notes and versioning notes.
-2. Update runbook commands if needed.
-3. Update state and readiness.
-4. If `AUTO_RELEASE_NOTES=1` in `.cursor/scratchpad.md`, generate
-   `handoffs/release_notes.md` via the release notes script.
-

package/.cursor/commands/gsd-research.md

@@ -1,28 +0,0 @@
----
-description: "GSD research: gather references and risks before architecture."
----
-
-# /gsd-research
-
-## Subagents
-- tech-lead
-- po
-
-## Inputs
-- `docs/product/vision.md`
-- `docs/product/backlog.md`
-- `docs/product/acceptance.md`
-
-## Outputs (artifacts)
-- `docs/engineering/research.md`
-- `docs/engineering/decisions.md`
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Decision gate triggered
-- Missing acceptance criteria
-
-## Steps
-1. Research relevant patterns, libraries, and risks.
-2. Summarize findings in `research.md`.
-3. Record any decisions and update state.

package/.cursor/commands/gsd-resume.md

@@ -1,26 +0,0 @@
----
-description: "GSD resume: load context pack and continue work."
----
-
-# /gsd-resume
-
-## Subagents
-- curator
-
-## Inputs
-- `docs/engineering/state.md`
-- `docs/engineering/decisions.md`
-- `sprints/S0001/summary.md`
-- `handoffs/resume_brief.md`
-
-## Outputs (artifacts)
-- Updated `docs/engineering/state.md` (if needed)
-
-## Stop conditions
-- Missing resume brief or stale state
-
-## Steps
-1. Load the context pack and open decisions.
-2. Summarize current status and next steps.
-3. Hand off to the appropriate phase.
-

package/.cursor/commands/gsd-sprint-plan.md

@@ -1,30 +0,0 @@
----
-description: "GSD sprint plan: create sprint and atomic tasks."
----
-
-# /gsd-sprint-plan
-
-## Subagents
-- tech-lead
-
-## Inputs
-- Architecture and decisions
-- Current backlog priorities
-
-## Outputs (artifacts)
-- `sprints/S0001/sprint.md`
-- `sprints/S0001/tasks.md`
-- `sprints/S0001/progress.md`
-- `handoffs/tl_to_dev.md`
- - `sprints/S0001/plan-verify.json` (after /gsd-plan-verify)
-
-## Stop conditions
-- Missing acceptance criteria
-- Decision gate triggered
-
-## Steps
-1. Create a sprint scope and goals.
-2. Break work into atomic tasks.
-3. Write TL -> Dev handoff.
-4. Run `/gsd-plan-verify` to check coverage.
-

package/.cursor/commands/gsd-verify-work.md

@@ -1,25 +0,0 @@
----
-description: "GSD verify work: guided user acceptance testing."
----
-
-# /gsd-verify-work
-
-## Subagents
-- qa
-
-## Inputs
-- `docs/product/acceptance.md`
-- `sprints/S0001/summary.md`
-
-## Outputs (artifacts)
-- `sprints/S0001/uat.json`
-- `sprints/S0001/uat.md`
-- `docs/engineering/state.md`
-
-## Stop conditions
-- Decision gate triggered
-
-## Steps
-1. Convert acceptance criteria into testable UAT steps.
-2. Record results and failures.
-3. Update state with pass/fail summary.

package/.cursor/hooks.json

@@ -1,26 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "beforeShellExecution": [
-      {
-        "command": "python .cursor/hooks/gsd-hook.py beforeShellExecution"
-      }
-    ],
-    "beforeReadFile": [
-      {
-        "command": "python .cursor/hooks/gsd-hook.py beforeReadFile"
-      }
-    ],
-    "afterFileEdit": [
-      {
-        "command": "python .cursor/hooks/gsd-hook.py afterFileEdit"
-      }
-    ],
-    "stop": [
-      {
-        "command": "python .cursor/hooks/gsd-hook.py stop"
-      }
-    ]
-  }
-}
-

package/.cursor/plans/cursor-gsd-team-kit_8cfee9b8.plan.md

@@ -1,57 +0,0 @@
----
-name: cursor-gsd-team-kit
-overview: Plan the build of the Cursor-native “GSD Team Kit” template repo described in `Plan.md`, covering commands, rules, skills, agents, hooks, docs, and CI/CD templates.
-todos:
-  - id: scaffold-structure
-    content: Scaffold directory structure and starter artifacts
-    status: pending
-  - id: commands-rules
-    content: Add 10 commands and 4 rules with IO/stop gates
-    status: pending
-  - id: skills-agents
-    content: Create gsd-team skill, templates, and 6 agents
-    status: pending
-  - id: hooks-cicd-docs
-    content: Implement hooks, CI/CD workflows, and README updates
-    status: pending
-isProject: false
----
-
-# Cursor-GSD-Team Kit Plan
-
-## Scope Summary
-
-Build a drop-in template repo that implements the full GSD workflow (intake → discovery → architecture → sprint plan → execute → QA → release → pause/resume) using Cursor-native artifacts: commands, rules, skills, subagents, hooks, docs, and GitHub Actions. Voice input is documented as an input layer only. CI/CD is template-based and driven by runbook keys.
-
-## Key Files and Structures
-
-- Template structure per spec: [.cursor/](.cursor/), [docs/](docs/), [sprints/](sprints/), [handoffs/](handoffs/), [decisions/](decisions/), [.github/workflows/](.github/workflows/)
-- Commands: `.cursor/commands/gsd-*.md` (10 commands)
-- Rules: `.cursor/rules/gsd-*.mdc` (4 rules)
-- Skills: `.cursor/skills/gsd-team/SKILL.md` + `templates/*.md`
-- Agents: `.cursor/agents/*.mdc` (PO, tech-lead, dev, QA, release, curator)
-- Hooks: `.cursor/hooks.json`, `.cursor/hooks/gsd-hook.py`, `.cursor/scratchpad.md`
-- Docs templates: `docs/product/*.md`, `docs/engineering/*.md`, `sprints/S0001/*`, `handoffs/*.md`, `decisions/DEC-0001.md`
-- CI/CD: `.github/workflows/ci.yml`, `.github/workflows/deploy.yml`
-- README updates: voice options + runbook usage
-
-## Implementation Outline
-
-1. **Scaffold repo layout** per section 4 and add starter artifacts in `docs/`, `sprints/`, `handoffs/`, `decisions/`.
-2. **Write 10 commands** in `.cursor/commands/` with explicit inputs/outputs, stop-conditions, and role usage.
-3. **Define rules** in `.cursor/rules/` for phase flow, quality gates, handoffs/state persistence, and escalation.
-4. **Create the skill** in `.cursor/skills/gsd-team/` and template files for story/acceptance/architecture/decision/sprint/handoff.
-5. **Define 6 subagents** with required IO and artifact persistence requirements.
-6. **Implement hooks** (`hooks.json` + dispatcher script) with fail-open logic, context-refresh checks, and safe-command blocking.
-7. **Add CI/CD workflows** that read `docs/engineering/runbook.md` keys and conditionally execute commands.
-8. **Update README** to document quick start, voice input strategies, and runbook-driven CI/CD.
-
-## Notes / Constraints
-
-- Voice input is documented only; no runtime integration beyond documentation.
-- Hooks and CI/CD must be fail-open unless commands are explicitly set.
-- Decision gate should create `decisions/DEC-xxxx.md` and stop until user decision.
-
-## Reference (Plan Spec)
-
-Primary source: [Plan.md](Plan.md)

package/.cursor/remote.json

@@ -1,18 +0,0 @@
-{
-  "servers": [
-    {
-      "name": "local-docker",
-      "type": "docker",
-      "host": "unix:///var/run/docker.sock",
-      "notes": "Example Docker socket configuration"
-    },
-    {
-      "name": "remote-ssh",
-      "type": "ssh",
-      "host": "example.com",
-      "port": 22,
-      "user": "ubuntu",
-      "notes": "Example SSH configuration"
-    }
-  ]
-}

package/.cursor/rules/gsd-core.mdc

@@ -1,18 +0,0 @@
----
-description: "GSD core workflow and context pack rules"
-globs: ["**/*"]
----
-
-- Use the GSD phase flow: intake -> discovery -> research -> architecture ->
-  sprint plan -> plan verify -> execute -> QA -> verify work -> release ->
-  refresh context.
-- `AUTO_FLOW_MODE` controls whether phases run automatically or stop at
-  decision gates (`auto_until_decision` recommended).
-- `PHASE_MODE=interactive` means ask questions; `PHASE_MODE=auto` minimizes
-  prompts unless decisions are required.
-- Persist decisions and state in files; do not keep critical info only in chat.
-- Pause/resume is first-class. Update `handoffs/resume_brief.md` on pause.
-- Context pack must stay compact: summarize, do not dump raw logs.
-- If `REMOTE_EXECUTION=1` and `.cursor/remote.json` is configured, the agent
-  may use the configured remote/docker servers for builds/tests.
-

package/.cursor/rules/gsd-handoffs.mdc

@@ -1,10 +0,0 @@
----
-description: "Handoffs and artifact persistence"
-globs: ["**/*"]
----
-
-- Every role writes handoffs to files; nothing important stays in chat only.
-- Update sprint `summary.md` and `progress.md` after task completion.
-- Use `handoffs/*.md` for role-to-role transfers.
-- Keep `docs/engineering/state.md` current and concise.
-

package/.cursor/rules/gsd-quality.mdc

@@ -1,15 +0,0 @@
----
-description: "Quality gates and small-step execution"
-globs: ["**/*"]
----
-
-- Prefer small, atomic changes tied to a single task.
-- Run tests, lint, and typecheck when commands are configured.
-- If `AUTO_INSTALL_DEPS=1` in `.cursor/scratchpad.md`, install required
-  runtimes/libs without asking (package manager only).
-- If `AUTO_RELEASE_NOTES=1` in `.cursor/scratchpad.md`, generate release notes
-  automatically (scripted).
-- If `PERMISSION_MODE=auto`, do not ask for routine permission prompts.
-- Update `docs/engineering/state.md` after meaningful changes.
-- If tests fail and commands are set, fix or document before proceeding.
-

package/.cursor/scratchpad.md

@@ -1,34 +0,0 @@
-# GSD scratchpad
-#
-# Core behavior
-# - GSD_CONTEXT_STRICT: 0|1 (require context refresh after code changes)
-# - LOOP_UNTIL_GREEN: 0|1 (optional test loop)
-# - RUN_TESTS_ON_EDIT: 0|1 (run tests after edits)
-# - DONE: 0|1 (stop hook loops)
-GSD_CONTEXT_STRICT=1
-LOOP_UNTIL_GREEN=0
-RUN_TESTS_ON_EDIT=0
-DONE=0
-#
-# Benchmarking
-# - GSD_BENCH_SESSION: free-form id for live benchmark logging
-GSD_BENCH_SESSION=
-#
-# Automation
-# - AUTO_FLOW_MODE: manual|auto_until_decision
-# - PHASE_MODE: interactive|auto
-# - PERMISSION_MODE: interactive|auto
-# - AUTO_INSTALL_DEPS: 0|1
-# - AUTO_RELEASE_NOTES: 0|1
-AUTO_FLOW_MODE=manual
-PHASE_MODE=interactive
-PERMISSION_MODE=interactive
-AUTO_INSTALL_DEPS=0
-AUTO_RELEASE_NOTES=0
-#
-# Remote execution
-# - REMOTE_EXECUTION: 0|1
-# - REMOTE_CONFIG: path to remote config
-REMOTE_EXECUTION=0
-REMOTE_CONFIG=.cursor/remote.json
-

package/.github/workflows/ci.yml

@@ -1,47 +0,0 @@
-name: ci
-
-on:
-  push:
-    branches: ["main"]
-  pull_request:
-
-jobs:
-  checks:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - id: runbook
-        name: Read runbook commands
-        run: |
-          python - <<'PY'
-          import os
-          import pathlib
-          import re
-
-          text = pathlib.Path("docs/engineering/runbook.md").read_text()
-
-          def get(key):
-              m = re.search(rf"^{key}:\s*(.*)$", text, re.M)
-              val = (m.group(1) or "").strip() if m else ""
-              if val in ("", "...", "<...>", "TODO"):
-                  return ""
-              return val
-
-          keys = ["TEST_COMMAND", "LINT_COMMAND", "TYPECHECK_COMMAND"]
-          with open(os.environ["GITHUB_OUTPUT"], "a") as f:
-              for key in keys:
-                  f.write(f"{key}={get(key)}\n")
-          PY
-      - name: Test
-        if: steps.runbook.outputs.TEST_COMMAND != ''
-        run: ${{ steps.runbook.outputs.TEST_COMMAND }}
-      - name: Lint
-        if: steps.runbook.outputs.LINT_COMMAND != ''
-        run: ${{ steps.runbook.outputs.LINT_COMMAND }}
-      - name: Typecheck
-        if: steps.runbook.outputs.TYPECHECK_COMMAND != ''
-        run: ${{ steps.runbook.outputs.TYPECHECK_COMMAND }}
-      - name: No commands set
-        if: steps.runbook.outputs.TEST_COMMAND == '' && steps.runbook.outputs.LINT_COMMAND == '' && steps.runbook.outputs.TYPECHECK_COMMAND == ''
-        run: echo "No runbook commands set."
-

package/decisions/DEC-0001.md

@@ -1,21 +0,0 @@
-# Decision DEC-0001
-
-Status: Proposed
-
-## Context
-
-- ...
-
-## Options
-
-1. Option A
-2. Option B
-3. Option C
-
-## Recommendation
-
-- ...
-
-## Impact
-
-- ...

package/decisions/DEC-0002.md

@@ -1,21 +0,0 @@
-# Decision DEC-0002
-
-Status: Proposed
-
-## Context
-
-- ...
-
-## Options
-
-1. Option A
-2. Option B
-3. Option C
-
-## Recommendation
-
-- ...
-
-## Impact
-
-- ...