You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
For project-wide conventions, read [`.github/copilot-instructions.md`](../../.github/copilot-instructions.md): licensing, security defaults, architecture, Makefile targets, documentation policy, and how skills are organized.
16
+
17
+
**Do not duplicate** policy from that file or from skills. Use short pointers only in Cursor rules.
18
+
19
+
## Skills
20
+
21
+
When the task touches a language, build system, tests, security, or documentation, discover and read the relevant `SKILL.md` under [`.github/skills/`](../../.github/skills/) (browse the directory or follow routing in `copilot-instructions.md`). Do not assume a fixed list of skill files.
22
+
23
+
## Service guides
24
+
25
+
Before substantive changes in a component tree, find and read `Agents.md` in that service’s directory (search upward from edited paths or the component root). Not every folder has one; use it when present.
26
+
27
+
## Cursor workflow
28
+
29
+
- Prefer root `Makefile` test targets unless a narrower pytest run is explicitly required (details live in skills).
30
+
- Run commands in the real environment; investigate failures before giving up.
31
+
- Commits and pull requests only when the user asks (see user/global Cursor rules).
32
+
- Keep changes minimal and match existing conventions in the touched area.
-`.github/skills/testing.md` - Loaded when task involves tests or `test` keyword detected
46
-
-`.github/skills/javascript.md` - Loaded when `.js` files are being edited
47
-
-`.github/skills/shell.md` - Loaded when `.sh` files are being edited
48
-
-`.github/skills/makefile.md` - Loaded when Makefile or build system changes
45
+
-`.github/skills/testing/SKILL.md` - Loaded when task involves tests or `test` keyword detected
46
+
-`.github/skills/javascript/SKILL.md` - Loaded when `.js` files are being edited
47
+
-`.github/skills/shell/SKILL.md` - Loaded when `.sh` files are being edited
48
+
-`.github/skills/makefile/SKILL.md` - Loaded when Makefile or build system changes
49
49
-`.github/skills/agent_evaluation/SKILL.md` - Loaded when task asks to evaluate, score, audit, review, or test the efficacy of an `Agents.md`
50
50
51
51
Skills are detected and loaded based on file type, task keywords, and context signals. Explicitly request a skill if the auto-detection doesn't load it.
@@ -81,7 +81,7 @@ Treat AI-generated output as **untrusted draft code** until reviewed and tested.
81
81
Reject suggestions that bypass security controls for convenience or introduce unsafe defaults.
82
82
83
83
For detailed security review guidance, follow:
84
-
`.github/skills/security.md`.
84
+
`.github/skills/security/SKILL.md`.
85
85
86
86
## Architecture Overview
87
87
@@ -131,7 +131,7 @@ make rebuild-core # Clean + build (useful after code changes)
131
131
132
132
## Testing Framework
133
133
134
-
**For comprehensive test creation guidance, see `.github/skills/testing.md`** - detailed instructions on creating unit, functional, integration, UI, and smoke tests with both positive and negative cases.
134
+
**For comprehensive test creation guidance, see `.github/skills/testing/SKILL.md`** - detailed instructions on creating unit, functional, integration, UI, and smoke tests with both positive and negative cases.
135
135
136
136
**Running Tests** (must have containers running via docker-compose):
137
137
@@ -145,11 +145,11 @@ make -C tests geometry-unit # Specific test (e.g., geo
145
145
### Completion Gate For Test Tasks (Critical)
146
146
147
147
For runtime test verification requirements, use
148
-
`.github/skills/test-verification-gate.md`.
148
+
`.github/skills/test-verification-gate/SKILL.md`.
149
149
150
150
### Containerized Test Image Freshness Gate (Critical)
151
151
152
-
Use `.github/skills/test-verification-gate.md` as the single source of truth
152
+
Use `.github/skills/test-verification-gate/SKILL.md` as the single source of truth
153
153
for image freshness checks, rebuild-before-test requirements, and retry policy
0 commit comments