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

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:
2026-03-19 15:00:56 +08:00
parent 2c09e66106
commit 8d704cf406
8 changed files with 356 additions and 0 deletions

View File

@@ -0,0 +1,29 @@
# Root `AGENTS.md` Template
Use this structure for the `AGENTS.md` at the root of the current Git working tree.
## Recommended Shape
```md
# Root Entry
- State that this file is the primary routing entrypoint for the repository's agentic documentation tree.
- Define the default path basis.
# Common Constraints
- Keep repository-wide rules here.
- Do not repeat topic-specific rules that belong in child docs.
# Required Instructions Before Editing
- Route to the required child instruction docs.
- Use explicit "Read and follow ..." wording.
```
## Notes
- Keep this file short.
- Treat this file as an instruction document, not a passive index.
- Route to child docs only when they are actually needed.
- Do not turn the root file into a dump of all topic-specific rules.