Skip to content

Rebuild agent skills around what the repo can't say about itself; measure every cut (closes #525) #740

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fangge518 merged 101 commits into from
Sep 4, 2026
Merged

Rebuild agent skills around what the repo can't say about itself; measure every cut (closes #525) #740

Show file tree
Hide file tree
Changes from 94 commits
Commits
Show all changes
101 commits
Select commit Hold shift + click to select a range
3f8fc26
Flatten Claude skill sync output — nested skills were never discovered
fangge518 Aug 27, 2026
3ee622d
Add AUTHORING.md — normative guide for writing agent skills
fangge518 Aug 27, 2026
c3d438d
Add quality-gate runbook: diff-scoped verification with concurrent gates
fangge518 Aug 27, 2026
83af3f6
Rewrite learn-backend, absorbing learn-db-query
fangge518 Aug 27, 2026
fcc1d38
Add map-onboarding runbook: the full new-layer onboarding sequence
fangge518 Aug 27, 2026
81155ba
Merge learn-frontend + learn-map-runtime + learn-map-layers + learn-w…
fangge518 Aug 27, 2026
3465916
Add migration-author runbook: generate, review, and validate Alembic …
fangge518 Aug 27, 2026
3fd547f
Rewrite learn-state-sync with grounded conflict model + debugging ref…
fangge518 Aug 27, 2026
6b65e06
Add learn-performance, new cross-cutting knowledge skill
fangge518 Aug 27, 2026
387935b
Merge learn-map-lifecycle + learn-pipelines into learn-map-data; add …
fangge518 Aug 27, 2026
820bf1b
Rewrite learn-auth-share as grounded, invariant-heavy security skill
fangge518 Aug 27, 2026
ee6d150
Add api-contract-audit runbook: static drift check between BE models …
fangge518 Aug 27, 2026
36b3c47
Add pr-review runbook: this repo's checkpoints on top of built-in review
fangge518 Aug 27, 2026
cbaf03f
Rename learn-cms-moderation to learn-cms, rewrite declaratively
fangge518 Aug 27, 2026
45bd35f
Add dependency-audit runbook: outdated/vulnerable dependency survey
fangge518 Aug 27, 2026
9b203ac
Rename learn-docker to learn-infra, narrow scope, add troubleshooting…
fangge518 Aug 27, 2026
9a06efe
Merge branch 'skills-rebuild/backend' into feat/agent-skills-rebuild
fangge518 Aug 27, 2026
6fdf38d
Merge branch 'skills-rebuild/runbooks' into feat/agent-skills-rebuild
fangge518 Aug 27, 2026
93c76d7
Point docs at the new skill inventory; tighten contract-audit matching
fangge518 Aug 27, 2026
a0c2358
learn-backend: fix the wrong contrast in the guard-vs-response bullet
fangge518 Aug 28, 2026
8e2f613
learn-backend: make the guard-vs-response bullet self-contained
fangge518 Aug 28, 2026
73d560b
learn-backend: correct the document/assignments split rationale
fangge518 Aug 28, 2026
8396801
learn-backend: fold dependency-choice rule into invariant, drop deriv…
fangge518 Aug 28, 2026
e570210
learn-backend: compress shattered-parent section to the non-derivable…
fangge518 Aug 28, 2026
ac6b426
learn-backend: inline shattered-parent write paths into the invariant…
fangge518 Aug 28, 2026
b24296a
learn-backend: drop transaction section duplicated by code docstrings
fangge518 Aug 28, 2026
588d29b
AUTHORING: add four-point review checklist from the learn-backend rev…
fangge518 Aug 28, 2026
1968f85
learn-map-frontend: fix broken commit-hash reference, cut unconfirmed…
fangge518 Aug 28, 2026
b474488
quality-gate: cut script-output restatement, fix CI re-validation ove…
fangge518 Aug 28, 2026
db6ea47
map-onboarding: fix batch-onboarding wrap claim to include parent-chi…
fangge518 Aug 28, 2026
e97d3b0
migration-author: fix include_object claim, no Wagtail/admin/cms sche…
fangge518 Aug 28, 2026
4675b08
api-contract-audit: cut Run-it prose duplicated by the script's own d…
fangge518 Aug 28, 2026
e2c6837
learn-performance: fix stale graph-cache location/size, trim derivabl…
fangge518 Aug 28, 2026
67fd01a
learn-auth-share: trim docstring paraphrases in the Turnstile and tok…
fangge518 Aug 28, 2026
f4f1d78
learn-cms: fix RichTextView naming error, cut a docstring paraphrase
fangge518 Aug 28, 2026
a7d2eeb
learn-infra: fix service count and db dependency claims
fangge518 Aug 28, 2026
7d1f35d
learn-infra/troubleshooting: cut root-cause restatements of SKILL.md …
fangge518 Aug 28, 2026
124fa8a
Merge branches 'skill-review/map', 'skill-review/crosscut' and 'skill…
fangge518 Aug 28, 2026
26f7882
learn-infra: rebuild around AWS deployment; compress local stack to n…
fangge518 Aug 28, 2026
b323325
infra/README: add WAF, graph-check, and Athena rows; drop completed f…
fangge518 Aug 28, 2026
0939966
learn-infra: drop LOAD_DATA first-seed content, README.md already own…
fangge518 Aug 28, 2026
25f9559
learn-infra: clarify node_modules bullet — what the mount hides, loca…
fangge518 Aug 28, 2026
ca1b09a
learn-infra: reframe Postgres version skew as local-vs-everywhere, mo…
fangge518 Aug 28, 2026
66e338b
learn-infra: drop the CI section and the skew bullet's decision aside…
fangge518 Aug 28, 2026
b4f008f
learn-infra: delete anticipated-failure troubleshooting reference
fangge518 Aug 28, 2026
2ed19ee
AUTHORING: replace routing assumptions with measured behavior (2026-0…
fangge518 Sep 1, 2026
f18a366
learn-auth-share: inline the get_document_public rule, fix stale ID-s…
fangge518 Sep 1, 2026
f8461d7
skills: reword descriptions in the model's own engineering nouns
fangge518 Sep 1, 2026
ecc3e67
skills: drop identifier names from descriptions; AUTHORING states the…
fangge518 Sep 1, 2026
9e11e5b
skills: restate the document-id boundary as the leak invariant, drop …
fangge518 Sep 1, 2026
06386ed
AUTHORING: tighten routing findings per review; add ablation-tested p…
fangge518 Sep 1, 2026
e647b5f
AUTHORING: path-derivability cut requires structural or choke-point e…
fangge518 Sep 1, 2026
543b439
AUTHORING: make the point-triage section cold-reader-safe
fangge518 Sep 1, 2026
48196f0
skills: apply the point-triage checks to the project skills
fangge518 Sep 1, 2026
faf3acc
skills: delete web-design-guidelines; prune next-best-practices to Di…
fangge518 Sep 1, 2026
7d2ef82
skills: dissolve next-best-practices into AGENTS.md; move next-upgrad…
fangge518 Sep 1, 2026
bc7c930
skills: flatten the source tree — project/ grouping dissolved
fangge518 Sep 1, 2026
5360f26
AUTHORING: rebuild around 'state what the repository cannot say about…
fangge518 Sep 3, 2026
408c3af
AUTHORING: principles only — experimental record moves to PR #740
fangge518 Sep 3, 2026
292476a
AUTHORING: descriptions as intent guesses; norm granularity; norms-fi…
fangge518 Sep 3, 2026
2088b16
AUTHORING: terminology discovery has no general recipe — case-by-case
fangge518 Sep 3, 2026
2c279a9
AUTHORING: cut context-dependent aside from the norms-description sen…
fangge518 Sep 3, 2026
892a214
AUTHORING: merge terminology and norms as the no-general-recipe cases…
fangge518 Sep 3, 2026
eab4b54
AUTHORING: add Testing skills section — official eval tooling over ha…
fangge518 Sep 3, 2026
a8f40ae
AUTHORING: restructure into include/exclude/placement doctrine (Ge + …
fangge518 Sep 3, 2026
8da3892
Rebuild skills per norm inventory: 5 norm skills, run-* runbooks, doc…
fangge518 Sep 3, 2026
dafec6a
Skill-cut challenge evals: 5 cases, official plugin-eval format + han…
fangge518 Sep 3, 2026
8094883
AUTHORING: pointer/reference principles; apply to backend-endpoints
fangge518 Sep 3, 2026
7e6c612
Eval: replace blank-map case with county-brush-debug grounded in issu…
fangge518 Sep 3, 2026
db35806
Evals: drop auth/cms cases (subsystems under overhaul), add partition…
fangge518 Sep 3, 2026
75b7429
Prune runbooks: cut script-output restatements and generic lore; add …
fangge518 Sep 3, 2026
cf25ac5
Fix event_id/eventId contract mismatch: frontend metadata field renam…
fangge518 Sep 3, 2026
d0325af
Revert "Fix event_id/eventId contract mismatch: frontend metadata fie…
fangge518 Sep 3, 2026
88791cb
run-dependency-audit: paths-gate on manifests instead of 'use periodi…
fangge518 Sep 3, 2026
c4031a5
Eval results applied: choke-point comment at sync merge; 721 status u…
fangge518 Sep 3, 2026
272fa56
Cut run-next-upgrade: rare procedure, rederivable from official guide…
fangge518 Sep 3, 2026
fbbe031
AGENTS.md: drop leftover run-next-upgrade listing line
fangge518 Sep 3, 2026
1112fb7
Cut run-pr-review: review checkpoints route through the audit skills'…
fangge518 Sep 3, 2026
8be38c6
Move skill-evals out of the repo: working material, not repo content …
fangge518 Sep 3, 2026
c9ab775
AUTHORING: eval suite reference points at districtr-scratchpad
fangge518 Sep 3, 2026
8a10291
Root AGENTS.md carries the agent instructions; CLAUDE.md injects it (…
fangge518 Sep 3, 2026
94b8a9d
Root AGENTS.md: cut derivable stack lines; dedupe beads/session block…
fangge518 Sep 3, 2026
08c225f
Dissolve Frontend Conventions: Bun line to root AGENTS.md; rest cut a…
fangge518 Sep 3, 2026
e398288
Hub AGENTS.md pass: one bd section (hook-aware), tree kept, generated…
fangge518 Sep 3, 2026
b4277ce
Quality gates: eager file points at run-quality-gate instead of dupli…
fangge518 Sep 3, 2026
563fe7f
Quick reference: drop skill counts and AUTHORING pointer; mark overvi…
fangge518 Sep 3, 2026
1809e53
Directory tree moves from the agent hub to docs/overview.md: a file m…
fangge518 Sep 3, 2026
e2bc2d9
Hub: cut the skills listing — every agent gets the descriptions at se…
fangge518 Sep 3, 2026
83a4554
Skills sync workflow: hub keeps the rule and one command; flags live …
fangge518 Sep 3, 2026
f9cdf02
Dissolve .agents/AGENTS.md: its two unique facts move to root AGENTS.…
fangge518 Sep 3, 2026
9dc0b20
ARCHITECTURE.md moves to docs/: .agents/ has no agentic meaning and i…
fangge518 Sep 3, 2026
80af4a2
Rename .agents/skills to agent-skills/: no harness reads .agents; a v…
fangge518 Sep 3, 2026
2b06b3d
Merge origin/dev (post-#721): infra/README conflict resolved (dev's /…
fangge518 Sep 3, 2026
251b397
run-quality-gate: reuse CI's pytest verdict when HEAD is exactly the …
fangge518 Sep 4, 2026
fff5460
run-gates.sh: suppress duplicate pytest PASS line on the CI-reuse path
fangge518 Sep 4, 2026
d22ef5e
Document the "Public" naming trap: read-only viewer, not a visibility…
fangge518 Sep 4, 2026
f4db3af
run-gates.sh: per-gate --only selection + incremental-push base-ref g…
fangge518 Sep 4, 2026
bb486ba
run-quality-gate: skip local pytest when the next operation triggers …
fangge518 Sep 4, 2026
8c19d3d
run-quality-gate: pytest rule sharpened to the two-case condition (pe…
fangge518 Sep 4, 2026
d1ed6ce
Quality gates: delete run-gates.sh, skill becomes judgment-first know…
fangge518 Sep 4, 2026
937be0c
Address PR #740 review: fix stale shatter claims, run not up, unwrap MD
fangge518 Sep 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
215 changes: 0 additions & 215 deletions .agents/AGENTS.md
View file
Open in desktop

This file was deleted.

76 changes: 0 additions & 76 deletions .agents/skills/next-best-practices/SKILL.md
View file
Open in desktop

This file was deleted.

73 changes: 0 additions & 73 deletions .agents/skills/next-best-practices/async-patterns.md
View file
Open in desktop

This file was deleted.

Loading