feat: TDD skill, session handoff, discovery checklist, brownfield qui…

[vaibhav-systango]

v1.2.0 — TDD Skill, Session Handoff, Discovery Enhancements

Branch: feat/v1.2-tdd-and-enhancements → main
Scope: 1 new skill + 3 enhancements + 2 distribution files. No new commands.

⚠️ Merge order: PR1 (feat/enterprise-fe-patterns-and-project-discovery) should merge first. Rebase this branch onto updated main before merging to avoid version conflicts (1.1.0 → 1.2.0).

---

What's New

🆕 New Skill: test-driven-development

skills/test-driven-development/SKILL.md — 141 lines

Fills a documented gap: generate-unit-tests explicitly tells agents "do not write tests first — that skill is post-implementation by design." This skill covers the intentional counterpart:

• RED → GREEN → REFACTOR loop, one behavior at a time
• Relationship table clarifying when to use TDD vs. generate-unit-tests vs. incremental-implementation
• Prove-It Checkpoint pattern (show failure before fix, pass after)
• No new slash commands

✨ Enhancement: Session Continuity in context-engineering

Adds Level 6: Session Continuity — a portable .context/handoff.md template for when a session ends mid-task or another engineer picks up. Format: decisions made, current state, next steps, open questions. Marked ephemeral: delete when the work stream is complete.

✨ Enhancement: Discovery Question Checklist in spec-driven-development

Expands the existing "ask clarifying questions" line into a 7-category structured checklist (Scope, Users & success, Constraints, Dependencies, Edge cases, Non-goals, Prior art). Replaces the proposed interview-me skill — same workflow, no new skill needed.

✨ Enhancement: Quick Overview + Circular Deps in brownfield-discovery

Two additions inspired by CC-v3's explore skill (audited — we kept our stronger .context/ model, cherry-picked 2 gaps):

• Quick Overview mode (~1 min): read README + manifest + dir tree → 10-line summary in chat. No agents spawned, no .context/ files. For orientation, not mapping.
• Circular dependency detection: Architecture agent brief now explicitly asks to flag circular imports. Added to .context/architecture.md template and verification checklist.

---

Distribution

File	What it adds
CONTRIBUTING.md	How to add/enhance skills, PR checklist, versioning guide
docs/windsurf-setup.md	Windsurf setup guide (mirrors cursor-setup.md)
.gitignore	Adds docs/proposal-*.md — internal drafts excluded from distribution

---

Routing

AGENTS.md, CLAUDE.md, README.md, skills/using-agent-skills/SKILL.md all updated with:

• test-driven-development in intent mapping and lifecycle
• generate-unit-tests description updated to clarify post-implementation scope
• CONTRIBUTING.md and docs/windsurf-setup.md linked from README

---

What's Deferred (with rationale)

Item	Why
ci-cd-pipeline skill	Too project-specific without clear scope — needs CTO alignment
.gemini/commands/*.toml	Dual command-set maintenance cost — needs CTO input on strategy
Pre-mortem step in planning	Already exists — planning/templates.md has a Risks and Mitigations table

---

Stats