public/bluecraft
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(bluecraft-agentic-docs): add agentic docs skill templates

Browse Source 
Add the Bluecraft Agentic Docs skill with guidance for maintaining
root `AGENTS.md` files and `agent-docs/` trees.

Include OpenAI agent metadata plus reference templates and checklists
for root routing, rule docs, inventory docs, and refactor validation.
This commit is contained in:
Ge Song
2026-03-19 15:00:56 +08:00
parent 2c09e66106
commit 8d704cf406
8 changed files with 356 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
skills/bluecraft-agentic-docs/references/refactor-checklist.md Normal file
View File

@@ -0,0 +1,19 @@
# Refactor Checklist
Use this checklist after changing the root `AGENTS.md` or any file in `agent-docs/`.
- Does each covered document own one clear topic?
- Does each filename clearly express the document's purpose?
- Does each opening explain purpose, trigger, and that the document must be followed in scope?
- Is the `AGENTS.md` at the root of the current Git working tree still the primary routing entrypoint?
- Does every active `agent-docs/` file have an explicit path from the root?
- Does each child doc use the right shape for its job: rule doc versus inventory doc?
- Did you remove stale references, filenames, and replaced paths?
- Did you remove any orphan instruction docs created by the refactor?
- Did you avoid duplicating the same rule across multiple active docs?
- Did you avoid mixing long entry inventories into rule docs when a separate inventory would be clearer?
- Is the default path basis still the root of the current Git working tree unless explicitly overridden?
- Are repository-wide constraints still in the root file?
- Are topic-specific constraints still in child docs?
- Did you keep routing depth minimal?
- If the repository has a validation command, did you run it?