From armory
Scaffolds per-repository agent context files including issue tracker rules, triage labels, domain glossary, ADR layout, and handoff conventions. Use when a repo needs durable agent context before planning, triage, or multi-agent work.
npx claudepluginhub mathews-tom/armory --plugin armoryThis skill uses the workspace's default tool permissions.
Scaffold the repo-local context files that make agent workflows consistent across sessions:
Sets up Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ for repo issue tracker (GitHub/GitLab/markdown), triage labels, and domain docs layout. Prerequisite for triage, to-issues skills.
Creates minimal, high-signal CLAUDE.md and AGENTS.md context files for repos using empirical best practices. Triggers on /init, create/update requests, or missing context during brainstorming.
Creates, updates, and maintains AGENTS.md/CLAUDE.md files with concise agent instructions derived from project toolchain analysis, enforcing minimal high-signal best practices.
Share bugs, ideas, or general feedback.
Scaffold the repo-local context files that make agent workflows consistent across sessions: issue tracker rules, triage labels, domain glossary layout, ADR layout, agent brief format, and out-of-scope memory.
| Use this skill | Use another package |
|---|---|
A repo lacks docs/agents/ context files | adr-writer for one architecture decision |
| Agents need consistent domain vocabulary | task-decomposer for an already-scoped feature |
| Triage or issue publishing needs label conventions | github for direct GitHub CLI operations |
| Multi-agent work needs durable issue briefs | handoff for session-local continuation notes |
| File | Contents | Load When |
|---|---|---|
references/context-format.md | CONTEXT.md and CONTEXT-MAP.md glossary format | Creating or editing domain docs |
references/agent-brief.md | Durable ready-for-agent issue brief contract | Preparing issue handoff |
references/out-of-scope.md | Persistent memory for rejected enhancements | Triage includes wontfix decisions |
Inspect the actual repo state before writing:
git remote -v and .git/config for issue tracker hintsAGENTS.md and CLAUDE.mdCONTEXT.md and CONTEXT-MAP.mddocs/adr/ and context-scoped ADR directoriesdocs/agents/.out-of-scope/Report what exists and what is missing. Do not overwrite existing files blindly.
Resolve these values with the user or from clear repo evidence:
| Decision | Default | Output |
|---|---|---|
| Issue tracker | GitHub if a GitHub remote exists, otherwise local markdown | docs/agents/issue-tracker.md |
| Triage labels | Canonical labels equal role names | docs/agents/triage-labels.md |
| Domain docs | Single root context | docs/agents/domain.md |
| Agent instructions file | Existing AGENTS.md, else existing CLAUDE.md | Updated ## Agent context block |
If both AGENTS.md and CLAUDE.md exist, update AGENTS.md for cross-agent portability.
If neither exists, ask before creating one.
Create or update these files:
docs/agents/
├── issue-tracker.md
├── triage-labels.md
└── domain.md
Use these conventions:
CONTEXT.md or CONTEXT-MAP.md with per-context glossaries.docs/adr/ for global decisions and context-local docs/adr/ directories where present.Add or update this block in the chosen instructions file:
## Agent context
### Issue tracker
See `docs/agents/issue-tracker.md` for where issues live and which operations agents may perform.
### Triage labels
See `docs/agents/triage-labels.md` for canonical triage roles and their concrete label strings.
### Domain docs
See `docs/agents/domain.md` for `CONTEXT.md`, `CONTEXT-MAP.md`, and ADR lookup rules.
Update the existing block in place if it already exists. Do not append duplicates.
Create CONTEXT.md only when the user has resolved at least one domain term. Use
references/context-format.md. Do not fill it with generic programming concepts.
Create CONTEXT-MAP.md only for multi-context repos where separate glossaries are needed.
docs/agents/issue-tracker.md exists and states the tracker, allowed operations, and required tools.docs/agents/triage-labels.md maps needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix.docs/agents/domain.md states single-context or multi-context layout and ADR lookup rules.## Agent context block.