Copilot instructions

1# Copilot Instructions
2 
3## Code Standards
4 
5Customize this section for your stack. Examples for common fighting styles:
6 
7### TypeScript (Default Example)
8- Always use TypeScript with `strict: true`
9- Naming: camelCase for variables/functions, PascalCase for components/types
10- Styling: Tailwind CSS + shadcn/ui components
11- Testing: Write Vitest tests for every new component/logic
12- Architecture: Next.js App Router, Server Actions, React Server Components when possible
13- Security: Never commit secrets, use environment variables
14 
15### Python
16- Type hints on all function signatures
17- Formatting: Black (line length 88)
18- Testing: pytest with fixtures, aim for >80% coverage
19- Linting: ruff or flake8
20- Architecture: FastAPI or Django conventions as applicable
21- Dependency management: pyproject.toml / requirements.txt pinned
22 
23### Java
24- Follow Google Java Style Guide
25- Testing: JUnit 5 + Mockito for unit tests
26- Build: Maven or Gradle (match existing project)
27- Architecture: Spring Boot patterns, constructor injection
28- Security: OWASP dependency check in CI
29 
30### Go
31- Follow standard library conventions and `go fmt`
32- Testing: table-driven tests with `testing` package
33- Error handling: explicit, no panic in library code
34- Architecture: clean package boundaries, interfaces for testability
35 
36### .NET
37- Nullable reference types enabled
38- Testing: xUnit + FluentAssertions
39- Architecture: clean architecture, MediatR for CQRS if applicable
40- Security: never log PII, use IOptions pattern for config
41 
42> **Pick your style.** Delete the others or keep them as reference.
43 
44## Superpowers Activated
45 
46At session start: read [SOUL.md](../SOUL.md) first — the identity charter defining **who the agent is, how it reasons, and where its limits are** — then load all skills from `skills/`. Follow the mandatory workflow. Never improvise.
47 
48See [skills.md](../skills.md) for the full skills index. Each skill is a self-contained folder under `skills/` with a `SKILL.md` file. Load the relevant skill when its trigger conditions are met.
49 
50### Mandatory Workflow Pipeline
51 
52Every non-trivial task follows this sequence:
53 
54```
55BRAINSTORM → WORKTREE → PLAN → EXECUTE → TEST → REVIEW → FINISH → LEARN
56```
57 
581. **[Brainstorming](../skills/brainstorming/SKILL.md)** → Socratic design refinement, get approval
592. **[Using git worktrees](../skills/using-git-worktrees/SKILL.md)** → Isolated workspace on feature branch
603. **[Plan before code](../skills/plan-before-code/SKILL.md)** → Break into tasks in `tasks/todo.md`
614. **[Executing plans](../skills/executing-plans/SKILL.md)** → One task at a time, verify each
625. **[Test writing](../skills/test-writing/SKILL.md)** → RED-GREEN-REFACTOR for every change
636. **[Requesting code review](../skills/requesting-code-review/SKILL.md)** → Self-review against plan
647. **[Finishing a development branch](../skills/finishing-a-development-branch/SKILL.md)** → Verify, merge decision, cleanup
658. **[Self-improvement](../skills/self-improvement/SKILL.md)** → Log lessons, update metrics
66 
67### Core Kata — 基本型 (always active)
68- **[Plan before code](../skills/plan-before-code/SKILL.md)**: Enter plan mode for any non-trivial task (3+ steps). Write plan to `tasks/todo.md`.
69- **[Verify before done](../skills/verify-before-done/SKILL.md)**: Run tests, check logs, diff against main. Never mark complete without proof.
70- **[Subagent strategy](../skills/subagent-strategy/SKILL.md)**: Offload research and parallel analysis to subagents. Keep context clean.
71- **[Self-improvement](../skills/self-improvement/SKILL.md)**: Capture lessons in `tasks/lessons.md` after any correction. Review at session start.
72- **[Demand elegance](../skills/demand-elegance/SKILL.md)**: Challenge shortcuts on non-trivial changes. Skip for simple fixes — don't over-engineer.
73- **[Autonomous bug fix](../skills/autonomous-bug-fix/SKILL.md)**: Reproduce → diagnose → fix → verify. Zero hand-holding. No context switching from the user.
74 
75### Flow Waza — 流れ技 (activate in sequence)
76- **[Brainstorming](../skills/brainstorming/SKILL.md)**: Refine ideas via Socratic questioning before code
77- **[Using git worktrees](../skills/using-git-worktrees/SKILL.md)**: Isolated workspace for every session
78- **[Executing plans](../skills/executing-plans/SKILL.md)**: Dispatch and execute tasks from todo.md
79- **[Requesting code review](../skills/requesting-code-review/SKILL.md)**: Self-review against plan between tasks
80- **[Receiving code review](../skills/receiving-code-review/SKILL.md)**: Process feedback and iterate
81- **[Finishing a development branch](../skills/finishing-a-development-branch/SKILL.md)**: Final verification + merge + cleanup
82- **[Dispatching parallel agents](../skills/dispatching-parallel-agents/SKILL.md)**: Concurrent sub-agent work when beneficial
83 
84### Practical Kumite — 実践組手 (load on demand)
85- **[Code review](../skills/code-review/SKILL.md)**: For reviewing PRs or diffs
86- **[Refactoring](../skills/refactoring/SKILL.md)**: For restructuring code safely
87- **[Test writing](../skills/test-writing/SKILL.md)**: For writing meaningful tests
88- **[PR workflow](../skills/pr-workflow/SKILL.md)**: For preparing merge-ready PRs
89- **[Debugging](../skills/debugging/SKILL.md)**: For systematic complex debugging
90- **[Codebase onboarding](../skills/codebase-onboarding/SKILL.md)**: For understanding unfamiliar repos
91 
92### Meta Dō — 道
93- **[Skill creator](../skills/skill-creator/SKILL.md)**: For creating new custom skills
94- **[Writing skills](../skills/writing-skills/SKILL.md)**: SKILL.md template and spec compliance
95- **[Using superpowers](../skills/using-superpowers/SKILL.md)**: Framework activator — loads everything
96 
97## Task Management
98 
991. **Session Start**: Load superpowers. Read `memory/INDEX.md`. Review `tasks/lessons.md`. Check git status.
1002. **Brainstorm**: For new features, refine design via Socratic questioning. Get approval.
1013. **Isolate**: Create git worktree or feature branch. Verify clean test baseline.
1024. **Plan**: Write plan to `tasks/todo.md` with checkable items.
1035. **Execute**: One task at a time. Verify after each. Commit per task.
1046. **Review**: Self-review against plan after each task/batch.
1057. **Verify Before Done**: Run `scripts/verify.sh` or manually run tests/diffs.
1068. **Finish**: Present merge options. Clean up worktree. Log lessons.
1079. **Learn**: Update `tasks/lessons.md` after corrections. Promote 3+ patterns to `memory/patterns/`. Record decisions in `memory/decisions/`. Write session summary to `memory/sessions/`. Run `scripts/link-index.sh`.
108 
109## Helper Scripts
110 
111The `/scripts/` directory contains automation helpers. Reference them in your workflow:
112 
113- **`scripts/init.sh`** — Scaffolds `tasks/todo.md` and `tasks/lessons.md` on first clone.
114- **`scripts/lesson-updater.sh`** — Scans `tasks/lessons.md` for recurring patterns (3+ occurrences) and proposes rule amendments to `skills.md`.
115- **`scripts/verify.sh`** — Pre-PR verification: runs tests, checks for uncommitted changes, validates that `tasks/todo.md` has a plan.
116- **`scripts/link-index.sh`** — Builds the memory vault link graph. Scans `memory/` for markdown links, generates backlink sections, updates `memory/INDEX.md` stats, and writes `memory/.link-graph.json` for programmatic queries.
117- **`scripts/memory-query.sh`** — Query the memory vault by tag, type, date, status, or free text. Use `--backlinks-for` to find what references a file. Lightweight Dataview replacement.
118- **`scripts/obsidian-sync.sh`** — Syncs `tasks/lessons.md` into the memory vault as `memory/patterns/` candidates.
119 
120Use these for all sessions to ensure consistency.
121 
122## Memory Vault
123 
124The `memory/` directory is the agent's persistent knowledge graph. It replaces flat-file memory with structured, linked knowledge.
125 
126```
127memory/
128├── INDEX.md              ← Map of Content (read this first)
129├── .link-graph.json      ← Machine-readable link graph
130├── decisions/            ← Architectural decisions with context
131├── patterns/             ← Proven rules promoted from lessons (3+ occurrences)
132├── preferences/          ← User behavioral preferences (learned over time)
133└── sessions/             ← Session summaries linking to everything above
134```
135 
136**Rules:**
137- Read `memory/INDEX.md` at every session start
138- Use relative markdown links between files (not wikilinks)
139- Run `scripts/link-index.sh` after creating or editing memory files
140- Query with `scripts/memory-query.sh` before reading every file manually
141- Templates in each subdirectory (`_template.md`) define the required structure
142