Skip to content

Add domain glossary and agent skill configuration#1768

Merged
kmcginnes merged 2 commits into
aws:mainfrom
kmcginnes:add-domain-docs
May 14, 2026
Merged

Add domain glossary and agent skill configuration#1768
kmcginnes merged 2 commits into
aws:mainfrom
kmcginnes:add-domain-docs

Conversation

@kmcginnes
Copy link
Copy Markdown
Collaborator

@kmcginnes kmcginnes commented May 14, 2026

Description

Bootstraps the project's domain vocabulary in CONTEXT.md and adds agent skill configuration under docs/agents/.

CONTEXT.md defines the canonical terms for the project's domain model (Vertex, Edge, Connection, Schema, etc.), documents UI translation conventions across query languages, flags legacy terms being phased out (Configuration, Attribute), and captures relationships between concepts.

docs/agents/ configures engineering skills (triage, to-issues, diagnose, etc.) with:

  • Issue tracker pointing at GitHub Issues
  • Default triage label vocabulary
  • Single-context domain doc layout

Ignore lists — adds .claude/ to .gitignore, .oxlintrc.json, and .oxfmtrc.jsonc so that Claude Code's local workspace files don't get committed or trip up linting/formatting tools.

How to read: Start with CONTEXT.md for the domain glossary, then glance at AGENTS.md (bottom) for the skill pointers and docs/agents/ for the skill-specific configs. The ignore-list changes are independent housekeeping.

Validation

  • Documentation and config only — no application code changes
  • pnpm checks passes with no errors

Related Issues

  • None

Check List

  • I confirm that my contribution is made under the terms of the Apache 2.0 license.
  • I have verified pnpm checks passes with no errors.
  • I have verified pnpm test passes with no failures.
  • I have covered new added functionality with unit tests if necessary.
  • I have updated documentation if necessary.

Bootstrap CONTEXT.md with the project's core domain vocabulary and
add agent skill docs (issue tracker, triage labels, domain layout) to
support engineering skills like triage, to-issues, and diagnose.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kmcginnes kmcginnes marked this pull request as ready for review May 14, 2026 17:10
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kmcginnes kmcginnes merged commit a5ddc5b into aws:main May 14, 2026
2 of 3 checks passed
@kmcginnes kmcginnes deleted the add-domain-docs branch May 14, 2026 22:25
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.

2 participants