Skip to content

docs: add agent skills configuration - #56

Open
sebawebber wants to merge 1 commit into
mainfrom
docs/agent-skills-setup
Open

docs: add agent skills configuration#56
sebawebber wants to merge 1 commit into
mainfrom
docs/agent-skills-setup

Conversation

@sebawebber

Copy link
Copy Markdown
Contributor

Summary

Scaffolds the per-repo configuration that the engineering skills
assume, so they stop guessing where work lives:

  • Issue tracker - GitHub issues via the gh CLI
  • Triage labels - the five canonical roles, defaults kept
  • Domain docs - single-context layout (CONTEXT.md + docs/adr/)

Changes

  • AGENTS.md - new "Agent skills" section pointing agents at the
    configuration files
  • docs/agents/issue-tracker.md - tracker conventions (new)
  • docs/agents/triage-labels.md - label vocabulary (new)
  • docs/agents/domain.md - domain-doc consumer rules (new)
  • CONTEXT.md - domain glossary the setup references

Notes

  • "PRs as a request surface" flag is left off in the issue
    tracker config.
  • Triage labels are the defaults; edit docs/agents/triage-labels.md
    to map to existing vocabulary.

Add the per-repo configuration that the engineering skills
assume: where issues live, the triage label vocabulary, and
the domain docs layout. Skills like to-tickets, triage, and
domain-modeling now read from docs/agents/* instead of
guessing, and AGENTS.md points agents at those files.

- AGENTS.md: add the Agent skills section (issue tracker,
  triage labels, domain docs pointers)
- docs/agents/issue-tracker.md: GitHub via the gh CLI
- docs/agents/triage-labels.md: default five canonical labels
- docs/agents/domain.md: single-context consumer rules
- CONTEXT.md: domain glossary the setup references

Signed-off-by: Sebastian Webber <sebastian@swebber.me>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant