Copilot instructions

1# Project Conventions
2 
3This project uses the ATV (Agentic Tool & Workflow) Starter Kit.
4 
5## Available Workflows
6 
7- `/ce-brainstorm` — Explore what to build through collaborative dialogue
8- `/ce-plan` — Create a structured implementation plan
9- `/ce-work` — Execute the plan with quality checks
10- `/ce-review` — Multi-agent code review
11- `/ce-compound` — Document solutions for future reference
12- `/lfg` — Full autonomous pipeline (plan → work → review)
13 
14## Documentation Structure
15 
16- `docs/plans/` — Implementation plans (living documents with checkboxes)
17- `docs/brainstorms/` — Brainstorm documents (what to build decisions)
18- `docs/solutions/` — Documented solutions (institutional knowledge)
19 
20## gstack Skills (if installed)
21 
22- `/office-hours` — YC-style forcing questions to reframe your product
23- `/plan-ceo-review` — Rethink the problem; find the 10-star product
24- `/plan-eng-review` — Lock architecture, data flow, edge cases
25- `/review` — Staff-level code review; auto-fix obvious issues
26- `/qa` — Test app in real browser, find and fix bugs (requires Bun)
27- `/ship` — Sync main, run tests, push, open PR
28- `/cso` — OWASP Top 10 + STRIDE threat model
29- `/careful` — Warn before destructive commands
30- `/investigate` — Systematic root-cause debugging
31- `/retro` — Weekly retrospective with trends
32 
33## Browser Automation (if installed)
34 
35- `agent-browser` — Vercel's headless browser CLI for AI agents (Rust native, fast)
36- Core workflow: `agent-browser open <url>` → `snapshot -i` → interact with `@refs` → re-snapshot
37- Install: `npm install -g agent-browser && agent-browser install`
38- Use for QA testing, form filling, screenshots, data extraction, and web automation
39 
40## ATV Override Rules
41 
42When both ATV and gstack provide similar functionality, ATV takes priority:
43 
44- **Design docs**: Write to `docs/brainstorms/` (ATV), not `DESIGN.md` (gstack)
45- **Solutions**: Document via `/ce-compound` into `docs/solutions/` (ATV), not gstack's `/retro`
46- **Plans**: Use `docs/plans/` with ATV naming (`YYYY-MM-DD-NNN-type-name-plan.md`)
47- **Reviews**: ATV's `/ce-review` agent selection governs; gstack's `/review` runs alongside
48- **Protected artifacts**: Never flag `docs/plans/`, `docs/solutions/`, `docs/brainstorms/`, `compound-engineering.local.md`, or `.github/skills/gstack/` for deletion
49 
50## Coding Conventions
51 
52- Follow existing patterns in the codebase
53- Write tests for new functionality
54- Use conventional commit messages (`feat:`, `fix:`, `refactor:`)
55 
56## Continuous Learning Pipeline
57 
58This project uses ATV's continuous learning system to capture and evolve patterns.
59 
60### Learning Commands
61 
62- `/learn` — Extract patterns from recent work into instincts
63- `/instincts` — View all learned patterns with confidence scores
64- `/evolve` — Promote mature instincts (confidence > 0.8) into full skills
65- `/observe` — Run a focused observation session on a specific domain
66- `/unslop` — Unified de-slop pass: strip AI-generated code slop, comment rot, and design slop
67 
68### How It Works
69 
701. **Observer hooks** automatically capture tool use data to `.atv/observations.jsonl`
712. **`/learn`** analyzes recent work and creates instincts in `.atv/instincts/project.yaml`
723. **Instincts** build confidence over time through repeated observation
734. **`/evolve`** promotes mature instincts into discoverable skills in `.github/skills/learned-*/`
74 
75### Key Files
76 
77- `.atv/observations.jsonl` — Raw tool use log (gitignored, ephemeral)
78- `.atv/instincts/project.yaml` — Learned patterns (committed, shared with team)
79- `.github/hooks/copilot-hooks.json` — Observer hook configuration
80- `.github/skills/learned-*/` — Auto-generated skills from evolved instincts
81 
82### Best Practices
83 
84- Run `/learn` after completing features or at session end
85- Run `/instincts` to check what patterns the project has learned
86- Run `/evolve` periodically to graduate well-established conventions
87- Run `/unslop` before PRs to strip AI-generated slop from code, comments, and UI
88- Review generated skills before committing — they're a starting point
89