Skip to content

docs(sync): refresh org agent instructions from skills/ADRs - #9

Open
darkmatter[bot] wants to merge 4 commits into
mainfrom
org-knowledge-sync/org-instructions
Open

docs(sync): refresh org agent instructions from skills/ADRs#9
darkmatter[bot] wants to merge 4 commits into
mainfrom
org-knowledge-sync/org-instructions

Conversation

@darkmatter

@darkmatter darkmatter Bot commented Jul 13, 2026

Copy link
Copy Markdown

Syncs CLAUDE.md, AGENTS.md, and .github/copilot-instructions.md with the current ADR set and skills catalog in darkmatter/skills.

ADR changes

  • Remove ADR-0001 (beads). The beads ADR, beads-setup skill, and beads-linear-sync skill were deleted from darkmatter/skills (commit f5f5227). All beads references (bd command table, beads-setup/beads-linear-sync skill entries, "Check for Beads first" convention) removed from all three files.
  • Add ADR-0006 (README minimum standard, accepted 2026-06-02) to all three files.
  • Add ADR-0007 (type-checked SQL in TypeScript, accepted 2026-06-16) to all three files.
  • Add ADR-0008 (per-language reference codebases, accepted 2026-07-09) to all three files.
  • Add working conventions for ADR-0006 (README standard) and ADR-0007 (type-checked SQL) to CLAUDE.md.

Skills changes

Removed ghost skills (not in catalog, no SKILL.md file):

  • systematic-debugging, verification-before-completion → replaced by diagnose
  • writing-plans, executing-plans, subagent-driven-development, dispatching-parallel-agents → removed (no catalog counterpart)
  • beads-setup, beads-linear-sync → removed (deleted from skills repo)

Added catalog skills previously missing from org files:

  • darkmatter-gitops-conventions (new)
  • darkmatter-ts-toolchain (new)
  • session-context-pipeline (new)
  • choose-dev-entrypoints, diagnose, grill-me, grill-with-docs, handoff, improve-codebase-architecture, prototype, run-ui-registry-variations, rust-best-practices, shadcn-registry-first, tdd, triage, ui-component-architecture, zoom-out

Source of truth: darkmatter/skills/docs/catalog.md and darkmatter/skills/docs/adr/.

Centaur Bot and others added 4 commits July 13, 2026 16:14
- Remove deleted ADR-0001 (beads) and beads skills from all org files
- Add ADR-0006 (README minimum standard), ADR-0007 (type-checked SQL),
  ADR-0008 (per-language reference codebases) to ADR tables
- Replace ghost skills (systematic-debugging, verification-before-completion,
  writing-plans, executing-plans, subagent-driven-development,
  dispatching-parallel-agents, beads-setup, beads-linear-sync) with catalog
  skills (diagnose, darkmatter-gitops-conventions, darkmatter-ts-toolchain,
  session-context-pipeline, and 13 other catalog skills previously missing)
- Update working conventions to reflect new ADRs
- Source of truth: darkmatter/skills
PR #9 added ADR-0006/0007/0008 and removed ADR-0001 but still listed
skills moved to inactive/ (brainstorming, caveman-commit, dm-skill-creator,
end-of-turn-review, receiving-code-review, requesting-code-review,
run-meeting-summary, test-driven-development, triage, kickoff-dm-design,
continuous-learning) and catalog-only skills with no SKILL.md (browser-use,
caveman, caveman-review, coding-standards, compress, frontend-design,
hl-funding-analysis, neon-postgres, openchronicle-setup) as invocable.
Removed all of those, added tdd and run-ui-registry-variations (active
skills that were missing), and dropped the now-empty Communication and
Domain sections.
- Add ADR-0009 (curate default skill bundle, superseded) and ADR-0010
  (install all catalogued skills) to ADR tables in all three files
- Add darkmatter-design-system skill (added to skills repo after PR #9
  opened) to UI/Frontend skill lists
- Add triage skill (catalog-listed but dropped by cleanup commit) back
  to Workflow skill lists
- Update CLAUDE.md skills catalog intro to reflect ADR-0010's rule
Move session-context-pipeline from Workflow/task-skill lists to a
distinct opt-in client runtimes section in all three org files.
Per ADR-0010 and docs/catalog.md, it is a presets/claude/runtime/
hook bundle, not an installed task skill — listing it under Workflow
implied automatic activation. Also add end-of-turn-review
(presets/base/runtime/) to the same opt-in section.
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.

0 participants