fraujulian/MyAiConfiguration
1
0 Fork 0
Code Issues Pull Requests Actions Activity

docs(skills): explain mandatory research workflow
CI / CI configuration security checks (push) Successful in 3s
Details
CI / Capabilities and shell quality (push) Successful in 17s
Details
CI / Python tests and compilation (push) Successful in 24s
Details
CI / Build and inspect generated packages (push) Successful in 42s
Details
CI / Bash integration and installation guards (push) Failing after 20s
Details
CI / PowerShell tests on Ubuntu (push) Failing after 1m27s
Details
CI / Installed client configuration smoke tests (push) Successful in 40s
Details
CI / QMD local search integration (push) Failing after 13m6s
Details

Browse Source
This commit is contained in:
Julian lechner committed 2026-10-08 13:55:28 +02:00
1 parent 21e3352456
commit fa43cb13ac
1 file changed
+4 -2
Download Patch File Download Diff File Expand all files Collapse all files
docs/skills.md
+4 -2
View File
@@ -5,7 +5,7 @@ Skills are reusable workflows. Rules are persistent constraints and agents are s
The current structure is organized by purpose: The current structure is organized by purpose:
- `planning/`: impact analysis and work-item definition - `planning/`: impact analysis and work-item definition
- `research/`: technical and repository research, plus `semantic-search`, which is installed only while local QMD search is enabled - `research/`: mandatory `research` gate for every search, with technical and repository specialists, plus `semantic-search`, which is installed only while local QMD search is enabled
- `reviews/`: security, performance, WPF, UI/UX, business, API, and EF Core reviews - `reviews/`: security, performance, WPF, UI/UX, business, API, and EF Core reviews
- `implementation/`: SQL, unit-test, and integration-test writing - `implementation/`: SQL, unit-test, and integration-test writing
- `verification/`: facts and work-item verification - `verification/`: facts and work-item verification
@@ -26,6 +26,8 @@ only when Claude invokes a matching skill instead of sitting permanently in cont
files directly. Both clients embed the general rules in their global instructions. files directly. Both clients embed the general rules in their global instructions.
Language, framework, library, and security rules use directory indexes plus focused topic files. Their generated Claude skills expose each focused rule separately; the index skills also include the references for contextual lookup. See [Configuration](configuration.md). Language, framework, library, and security rules use directory indexes plus focused topic files. Their generated Claude skills expose each focused rule separately; the index skills also include the references for contextual lookup. See [Configuration](configuration.md).
Skills guide a task when needed; their availability does not require a full review, build, or test suite after every Every search or lookup must use `research` and the applicable specialist, including direct reads, exact matches, familiar areas, and follow-up queries during implementation or verification. Loaded instructions can be reused; their checks apply to each search. Semantic retrieval runs first for unknown repository identifiers; known identifiers still use direct reads or `rg` within the research workflow. Disabling QMD does not disable the research requirement. These are agent instructions, not a runtime tool interceptor.
Other skills guide a task when needed; their availability does not require a full review, build, or test suite after every
change. The shared Verification rules govern proportional checking, including when generic skill workflows call change. The shared Verification rules govern proportional checking, including when generic skill workflows call
for more work than the change needs. for more work than the change needs.