ronce-racine 0.7.0 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +14 -9
- package/README.md +407 -220
- package/dist/hooks/README.md +137 -11
- package/dist/hooks/readme-freshness.mjs +9 -7
- package/dist/hooks/shell-read-guard.mjs +115 -0
- package/dist/hooks/skill-reminder.mjs +51 -24
- package/dist/hooks/skill-scoring.mjs +89 -0
- package/dist/hooks/truncate-bash-output.mjs +17 -7
- package/dist/hooks/truncate-output.mjs +60 -12
- package/dist/install.js +28 -10
- package/dist/src/catalog.js +6 -1
- package/dist/src/lock.js +54 -3
- package/dist/src/settings.js +134 -7
- package/dist/src/uninstall.js +22 -12
- package/docs/adopting-a-repo.md +46 -38
- package/docs/architecture.md +3 -47
- package/docs/catalog.md +2 -1
- package/docs/decisions.md +52 -0
- package/docs/developing.md +17 -8
- package/docs/distribution-model.md +27 -0
- package/docs/evaluating-skills.md +1093 -15
- package/docs/fixtures.md +93 -0
- package/docs/measuring-prose.md +253 -0
- package/docs/postmortems/2026-08-24-hook-portability.md +216 -0
- package/docs/quality-bar.md +32 -3
- package/docs/rules-hooks-agents.md +56 -0
- package/docs/the-ronce-mod.md +141 -0
- package/docs/ticket-form.md +94 -0
- package/docs/writing-a-skill.md +81 -13
- package/package.json +7 -3
- package/skills/adversarial-feature-challenge/CHANGELOG.md +23 -0
- package/skills/adversarial-feature-challenge/SKILL.md +5 -13
- package/skills/api-contract-versioning/CHANGELOG.md +10 -0
- package/skills/api-contract-versioning/SKILL.md +0 -6
- package/skills/audit-architecture/CHANGELOG.md +8 -0
- package/skills/audit-architecture/SKILL.md +0 -4
- package/skills/audit-ci-cd/CHANGELOG.md +10 -0
- package/skills/audit-ci-cd/SKILL.md +0 -6
- package/skills/audit-compliance/CHANGELOG.md +8 -0
- package/skills/audit-compliance/SKILL.md +0 -4
- package/skills/audit-industrialisation/CHANGELOG.md +10 -0
- package/skills/audit-industrialisation/SKILL.md +0 -6
- package/skills/audit-observability/CHANGELOG.md +8 -0
- package/skills/audit-observability/SKILL.md +0 -4
- package/skills/audit-performance-frontend/CHANGELOG.md +12 -0
- package/skills/audit-performance-frontend/SKILL.md +0 -8
- package/skills/audit-quality/CHANGELOG.md +10 -0
- package/skills/audit-quality/SKILL.md +0 -6
- package/skills/audit-report/CHANGELOG.md +28 -0
- package/skills/audit-report/SKILL.md +3 -9
- package/skills/audit-report/reference/apparatus.md +66 -0
- package/skills/audit-security/CHANGELOG.md +8 -0
- package/skills/audit-security/README.md +1 -0
- package/skills/audit-security/SKILL.md +6 -51
- package/skills/audit-store-review/CHANGELOG.md +8 -0
- package/skills/audit-store-review/README.md +22 -0
- package/skills/audit-store-review/SKILL.md +82 -0
- package/skills/audit-store-review/reference/google-play-rules.md +76 -0
- package/skills/audit-testing/CHANGELOG.md +10 -0
- package/skills/audit-testing/SKILL.md +4 -60
- package/skills/bug-ticket-root-cause/CHANGELOG.md +19 -0
- package/skills/bug-ticket-root-cause/SKILL.md +3 -9
- package/skills/bug-triage-structured/CHANGELOG.md +12 -0
- package/skills/bug-triage-structured/SKILL.md +0 -8
- package/skills/ci-pipeline-orchestration/CHANGELOG.md +10 -0
- package/skills/ci-pipeline-orchestration/SKILL.md +0 -6
- package/skills/commit-readiness-review/CHANGELOG.md +21 -0
- package/skills/commit-readiness-review/SKILL.md +4 -14
- package/skills/comprehensive-test-strategy/CHANGELOG.md +10 -0
- package/skills/comprehensive-test-strategy/SKILL.md +0 -6
- package/skills/daily-workflow-optimization/CHANGELOG.md +10 -0
- package/skills/daily-workflow-optimization/SKILL.md +0 -6
- package/skills/database-schema-evolution/CHANGELOG.md +10 -0
- package/skills/database-schema-evolution/SKILL.md +0 -6
- package/skills/ddd-backend-implementation/CHANGELOG.md +10 -0
- package/skills/ddd-backend-implementation/SKILL.md +0 -6
- package/skills/design-system-component-lifecycle/CHANGELOG.md +10 -0
- package/skills/design-system-component-lifecycle/SKILL.md +0 -6
- package/skills/detection-sweep/CHANGELOG.md +16 -0
- package/skills/detection-sweep/SKILL.md +0 -12
- package/skills/domain-glossary/CHANGELOG.md +8 -0
- package/skills/domain-glossary/SKILL.md +0 -4
- package/skills/domain-modeling-design/CHANGELOG.md +8 -0
- package/skills/domain-modeling-design/SKILL.md +0 -4
- package/skills/frontend-fullstack-implementation/CHANGELOG.md +10 -0
- package/skills/frontend-fullstack-implementation/SKILL.md +0 -6
- package/skills/frontend-spec-call-site-audit/CHANGELOG.md +14 -0
- package/skills/frontend-spec-call-site-audit/SKILL.md +0 -10
- package/skills/merge-request-review/CHANGELOG.md +10 -0
- package/skills/merge-request-review/SKILL.md +0 -6
- package/skills/performance-profiling/CHANGELOG.md +24 -0
- package/skills/performance-profiling/SKILL.md +16 -9
- package/skills/performance-profiling/reference/statistics.md +4 -1
- package/skills/production-incident-diagnostic/CHANGELOG.md +22 -0
- package/skills/production-incident-diagnostic/SKILL.md +6 -11
- package/skills/qa-session-intake/CHANGELOG.md +10 -0
- package/skills/qa-session-intake/SKILL.md +0 -6
- package/skills/recording-decisions/CHANGELOG.md +10 -0
- package/skills/recording-decisions/SKILL.md +0 -6
- package/skills/recurring-bug-root-cause/CHANGELOG.md +12 -0
- package/skills/recurring-bug-root-cause/README.md +1 -0
- package/skills/recurring-bug-root-cause/SKILL.md +0 -8
- package/skills/refactoring-shared-component-api/CHANGELOG.md +14 -0
- package/skills/refactoring-shared-component-api/README.md +1 -0
- package/skills/refactoring-shared-component-api/SKILL.md +0 -10
- package/skills/validating-features-end-to-end/CHANGELOG.md +10 -0
- package/skills/validating-features-end-to-end/SKILL.md +0 -6
- package/skills/visual-regression-check/CHANGELOG.md +21 -0
- package/skills/visual-regression-check/README.md +17 -0
- package/skills/visual-regression-check/SKILL.md +5 -9
- package/skills/writing-robust-tests/CHANGELOG.md +11 -0
- package/skills/writing-robust-tests/SKILL.md +0 -10
package/AGENTS.md
CHANGED
|
@@ -22,6 +22,8 @@ Canonical source of **generic Claude Code config** (project-agnostic), installab
|
|
|
22
22
|
```bash
|
|
23
23
|
npx ronce-racine plan <repo> # detects the stack, PROPOSES (read-only)
|
|
24
24
|
npx ronce-racine install <repo> [--all] # copies relevant rules/skills/hooks/agents + lockfile
|
|
25
|
+
npx ronce-racine install <repo> --yes # no selector: the pre-checked set (CI, non-TTY)
|
|
26
|
+
npx ronce-racine install <repo> --pick <kind:name...> # exactly these tokens, nothing else
|
|
25
27
|
npx ronce-racine check <repo> [--strict] # drift vs canonical (soft, or blocking)
|
|
26
28
|
npx ronce-racine detach <repo> <kind:name> # excludes a customized artifact from control
|
|
27
29
|
npx ronce-racine uninstall <repo> [--dry-run] # removes what the lockfile records, and only that
|
|
@@ -48,6 +50,7 @@ The `tools/skills.ts hooks` harness checks these two fields on every `npm test`.
|
|
|
48
50
|
| `session-inject.ts` | `SessionStart` | `compact` |
|
|
49
51
|
| `session-precompact.ts` | `PreCompact` | none |
|
|
50
52
|
| `worktree-env-setup.ts` | `SessionStart` | none |
|
|
53
|
+
| `readme-freshness.ts` | `PreToolUse` | `Bash` |
|
|
51
54
|
|
|
52
55
|
The `install.ts` installer merges the hook wirings for the selected hooks into `<repo>/.claude/settings.json` (deep-merge by event + matcher, idempotent, writes a `settings.json.bak` backup, preserves unrelated settings).
|
|
53
56
|
|
|
@@ -57,22 +60,22 @@ The `install.ts` installer merges the hook wirings for the selected hooks into `
|
|
|
57
60
|
2. The skill must be generic, follow the standard sections, and have a `name` + `description` frontmatter ("Use when …", third person, **describes WHEN not HOW**) + `version` (semver) + `metadata.last-reviewed` + `category`.
|
|
58
61
|
3. Body < 500 lines; beyond that → progressive disclosure (`reference/*.md`). Runnable detection → `scripts/*.ts` (never `.sh`). Output template → `templates/`.
|
|
59
62
|
4. Bump `version` + `last-reviewed`, add a line to the `## Changelog`.
|
|
60
|
-
5. `npm test` green, then update the
|
|
63
|
+
5. `npm test` green, then update `docs/catalog.md` (the README has no per-skill table).
|
|
61
64
|
|
|
62
65
|
## Modifying / adding a rule
|
|
63
66
|
|
|
64
67
|
1. Read `docs/writing-a-rule.md` + `docs/templates/rule.template.md`.
|
|
65
68
|
2. Frontmatter: `paths` (globs; omit = always-on) + `version` + `metadata.last-reviewed`. Body: imperative, short bullets, no magic numbers.
|
|
66
|
-
3. `npm test` green + `README.md
|
|
69
|
+
3. `npm test` green + the rules table in `README.md`.
|
|
67
70
|
|
|
68
71
|
## Harness (`npm test`)
|
|
69
72
|
|
|
70
|
-
|
|
71
|
-
- `
|
|
72
|
-
- `
|
|
73
|
-
- `
|
|
74
|
-
- `
|
|
75
|
-
- `
|
|
73
|
+
The exact chain is `package.json`'s `test` script - read it there rather than from a list that goes stale. It runs the `tools/skills.ts` subcommands (`validate`, `triggers`, `routing`, `rules`, `scripts`, `hooks`, `agents`, `templates`, `docs`), then `tools/eval-lint.ts`, `tools/portability.ts`, and finally `vitest run`. All must pass. Highlights:
|
|
74
|
+
- `validate` - frontmatter, version, sections, `reference/`/`scripts/`/`templates/` links, depth ≤ 1.
|
|
75
|
+
- `triggers` / `routing` - routing discriminability (each quoted trigger classifies its skill in the top-3; each routing case beats the neighbours it declares).
|
|
76
|
+
- `hooks` - presence and validity of `@version` (semver) and `@last-reviewed` (ISO date) in each `hooks/*.ts`.
|
|
77
|
+
- `docs` - documented claims checked against what the installer actually does.
|
|
78
|
+
- `eval-lint` - a gate whose literal its own prompt hands over.
|
|
76
79
|
|
|
77
80
|
Useful commands: `npm run skills:list`, `npm run skills:triggers`, `npm run rules:validate`, `npm run typecheck`.
|
|
78
81
|
|
|
@@ -83,7 +86,9 @@ rules/ skills/<name>/SKILL.md (+ reference/ scripts/ templates/)
|
|
|
83
86
|
hooks/ agents/ scripts/
|
|
84
87
|
install.ts (user-facing CLI, at the root: commands + argument parsing)
|
|
85
88
|
src/ (the CLI split up: paths, lock, catalog, detect, settings, selector, uninstall)
|
|
86
|
-
tools/ (internal harnesses: skills.ts,
|
|
89
|
+
tools/ (internal harnesses, all via tsx: skills.ts, mutations.ts, portability.ts,
|
|
90
|
+
build.ts, and the eval family: eval.ts, eval-tasks.ts, eval-grade.ts,
|
|
91
|
+
eval-judge.ts, eval-report.ts, eval-lint.ts)
|
|
87
92
|
docs/ templates/ README.md AGENTS.md
|
|
88
93
|
```
|
|
89
94
|
|