Repository navigation
docs(sync): refresh org agent instructions from skills/ADRs - #9
Open
darkmatter[bot] wants to merge 9 commits into
Open
darkmatter[bot] wants to merge 9 commits into
darkmatter[bot] wants to merge 9 commits into
Conversation
- 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.
Extend ADR tables with 0011 (SOPS JSON), 0012 (ops scripts in TS), 0013 (shared UI package), 0014 (named config files), 0015 (cohesive modules, superseding 0007's SQL ban), 0015 (hostnames by audience), and 0016 (Gherkin acceptance). Rebuild skill lists from the current skills/ inventory: retire phantom skills, add advisor, codebase- design, darkmatter-repo-setup, domain-organization, flue, keep-codebase-maintainable, and swap tdd for when-to-write-tests / opt-in test-driven-development. Client runtimes now list only the presets that exist: session-context-pipeline (Claude), continuous-learning and strategic-compact (OpenCode).
advisor and darkmatter-repo-setup exist on disk but are not in docs/catalog.md; drop them from the org files until catalogued.
Sync with darkmatter/skills ae06a89: catalog wording for alchemy, darkmatter-ts-toolchain and effect-typescript (Effect 4, effect-orpc, Postgres-first, tsgo, oxlint/oxfmt); add darkmatter-repo-setup and uncatalogued advisor; list end-of-turn-review runtime; link shared docs/agents topics; label OTel as a non-ADR org convention.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Syncs
CLAUDE.md,AGENTS.md, and.github/copilot-instructions.mdwith the current ADR set and skills catalog indarkmatter/skills(source head9facc57, 2026-09-18).ADR changes
All three files now cover every accepted ADR:
*.sops.json).api.dm.shis the single service hostname; Workers attach plural path prefixes via zone routes. Flagged the duplicate 0015 numbering (cite by title).Skills changes
Skill lists rebuilt from the 26-row
docs/catalog.md:skills/:grill-me,grill-with-docs,handoff,tdd,triage,zoom-out,improve-codebase-architecture,finishing-a-development-branch,prototype,writing-skills,nextjs-to-rwsdk-migration,using-superpowers,end-of-turn-review, and other stale entries.when-to-write-tests,codebase-design,domain-organization,keep-codebase-maintainable,flue, andtest-driven-development(relabeled opt-in; ordinary test requests usewhen-to-write-tests).presets/claude/runtime/session-context-pipeline,presets/opencode/runtime/continuous-learning,presets/opencode/runtime/strategic-compact.md.advisoranddarkmatter-repo-setupexist on disk but are uncatalogued; they stay out of the org files until catalogued indarkmatter/skills.Source of truth:
darkmatter/skills/docs/catalog.mdanddarkmatter/skills/docs/adr/.