ronce-racine 0.8.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.
Files changed (108) hide show
  1. package/AGENTS.md +14 -9
  2. package/README.md +407 -220
  3. package/dist/hooks/README.md +77 -1
  4. package/dist/hooks/shell-read-guard.mjs +115 -0
  5. package/dist/hooks/skill-reminder.mjs +41 -19
  6. package/dist/hooks/skill-scoring.mjs +89 -0
  7. package/dist/hooks/truncate-output.mjs +35 -1
  8. package/dist/install.js +13 -7
  9. package/dist/src/catalog.js +6 -1
  10. package/dist/src/lock.js +54 -3
  11. package/dist/src/uninstall.js +11 -6
  12. package/docs/adopting-a-repo.md +46 -38
  13. package/docs/architecture.md +3 -47
  14. package/docs/catalog.md +2 -1
  15. package/docs/decisions.md +12 -0
  16. package/docs/developing.md +17 -8
  17. package/docs/distribution-model.md +27 -0
  18. package/docs/evaluating-skills.md +1093 -15
  19. package/docs/fixtures.md +93 -0
  20. package/docs/measuring-prose.md +253 -0
  21. package/docs/quality-bar.md +32 -3
  22. package/docs/rules-hooks-agents.md +56 -0
  23. package/docs/the-ronce-mod.md +141 -0
  24. package/docs/ticket-form.md +94 -0
  25. package/docs/writing-a-skill.md +81 -13
  26. package/package.json +5 -2
  27. package/skills/adversarial-feature-challenge/CHANGELOG.md +23 -0
  28. package/skills/adversarial-feature-challenge/SKILL.md +5 -13
  29. package/skills/api-contract-versioning/CHANGELOG.md +10 -0
  30. package/skills/api-contract-versioning/SKILL.md +0 -6
  31. package/skills/audit-architecture/CHANGELOG.md +8 -0
  32. package/skills/audit-architecture/SKILL.md +0 -4
  33. package/skills/audit-ci-cd/CHANGELOG.md +10 -0
  34. package/skills/audit-ci-cd/SKILL.md +0 -6
  35. package/skills/audit-compliance/CHANGELOG.md +8 -0
  36. package/skills/audit-compliance/SKILL.md +0 -4
  37. package/skills/audit-industrialisation/CHANGELOG.md +10 -0
  38. package/skills/audit-industrialisation/SKILL.md +0 -6
  39. package/skills/audit-observability/CHANGELOG.md +8 -0
  40. package/skills/audit-observability/SKILL.md +0 -4
  41. package/skills/audit-performance-frontend/CHANGELOG.md +12 -0
  42. package/skills/audit-performance-frontend/SKILL.md +0 -8
  43. package/skills/audit-quality/CHANGELOG.md +10 -0
  44. package/skills/audit-quality/SKILL.md +0 -6
  45. package/skills/audit-report/CHANGELOG.md +28 -0
  46. package/skills/audit-report/SKILL.md +3 -9
  47. package/skills/audit-report/reference/apparatus.md +66 -0
  48. package/skills/audit-security/CHANGELOG.md +8 -0
  49. package/skills/audit-security/README.md +1 -0
  50. package/skills/audit-security/SKILL.md +6 -51
  51. package/skills/audit-store-review/CHANGELOG.md +8 -0
  52. package/skills/audit-store-review/README.md +22 -0
  53. package/skills/audit-store-review/SKILL.md +82 -0
  54. package/skills/audit-store-review/reference/google-play-rules.md +76 -0
  55. package/skills/audit-testing/CHANGELOG.md +10 -0
  56. package/skills/audit-testing/SKILL.md +4 -60
  57. package/skills/bug-ticket-root-cause/CHANGELOG.md +19 -0
  58. package/skills/bug-ticket-root-cause/SKILL.md +3 -9
  59. package/skills/bug-triage-structured/CHANGELOG.md +12 -0
  60. package/skills/bug-triage-structured/SKILL.md +0 -8
  61. package/skills/ci-pipeline-orchestration/CHANGELOG.md +10 -0
  62. package/skills/ci-pipeline-orchestration/SKILL.md +0 -6
  63. package/skills/commit-readiness-review/CHANGELOG.md +21 -0
  64. package/skills/commit-readiness-review/SKILL.md +4 -14
  65. package/skills/comprehensive-test-strategy/CHANGELOG.md +10 -0
  66. package/skills/comprehensive-test-strategy/SKILL.md +0 -6
  67. package/skills/daily-workflow-optimization/CHANGELOG.md +10 -0
  68. package/skills/daily-workflow-optimization/SKILL.md +0 -6
  69. package/skills/database-schema-evolution/CHANGELOG.md +10 -0
  70. package/skills/database-schema-evolution/SKILL.md +0 -6
  71. package/skills/ddd-backend-implementation/CHANGELOG.md +10 -0
  72. package/skills/ddd-backend-implementation/SKILL.md +0 -6
  73. package/skills/design-system-component-lifecycle/CHANGELOG.md +10 -0
  74. package/skills/design-system-component-lifecycle/SKILL.md +0 -6
  75. package/skills/detection-sweep/CHANGELOG.md +16 -0
  76. package/skills/detection-sweep/SKILL.md +0 -12
  77. package/skills/domain-glossary/CHANGELOG.md +8 -0
  78. package/skills/domain-glossary/SKILL.md +0 -4
  79. package/skills/domain-modeling-design/CHANGELOG.md +8 -0
  80. package/skills/domain-modeling-design/SKILL.md +0 -4
  81. package/skills/frontend-fullstack-implementation/CHANGELOG.md +10 -0
  82. package/skills/frontend-fullstack-implementation/SKILL.md +0 -6
  83. package/skills/frontend-spec-call-site-audit/CHANGELOG.md +14 -0
  84. package/skills/frontend-spec-call-site-audit/SKILL.md +0 -10
  85. package/skills/merge-request-review/CHANGELOG.md +10 -0
  86. package/skills/merge-request-review/SKILL.md +0 -6
  87. package/skills/performance-profiling/CHANGELOG.md +24 -0
  88. package/skills/performance-profiling/SKILL.md +16 -9
  89. package/skills/performance-profiling/reference/statistics.md +4 -1
  90. package/skills/production-incident-diagnostic/CHANGELOG.md +22 -0
  91. package/skills/production-incident-diagnostic/SKILL.md +6 -11
  92. package/skills/qa-session-intake/CHANGELOG.md +10 -0
  93. package/skills/qa-session-intake/SKILL.md +0 -6
  94. package/skills/recording-decisions/CHANGELOG.md +10 -0
  95. package/skills/recording-decisions/SKILL.md +0 -6
  96. package/skills/recurring-bug-root-cause/CHANGELOG.md +12 -0
  97. package/skills/recurring-bug-root-cause/README.md +1 -0
  98. package/skills/recurring-bug-root-cause/SKILL.md +0 -8
  99. package/skills/refactoring-shared-component-api/CHANGELOG.md +14 -0
  100. package/skills/refactoring-shared-component-api/README.md +1 -0
  101. package/skills/refactoring-shared-component-api/SKILL.md +0 -10
  102. package/skills/validating-features-end-to-end/CHANGELOG.md +10 -0
  103. package/skills/validating-features-end-to-end/SKILL.md +0 -6
  104. package/skills/visual-regression-check/CHANGELOG.md +21 -0
  105. package/skills/visual-regression-check/README.md +17 -0
  106. package/skills/visual-regression-check/SKILL.md +5 -9
  107. package/skills/writing-robust-tests/CHANGELOG.md +11 -0
  108. 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 table in `README.md`.
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` table.
69
+ 3. `npm test` green + the rules table in `README.md`.
67
70
 
68
71
  ## Harness (`npm test`)
69
72
 
70
- Five axes, all must pass:
71
- - `tools/skills.ts validate` - frontmatter, version, sections, `reference/`/`scripts/`/`templates/` links, depth ≤ 1.
72
- - `tools/skills.ts triggers` - routing discriminability (each quoted trigger classifies its skill in the top-3).
73
- - `tools/skills.ts rules` - versioning of the rules.
74
- - `tools/skills.ts scripts` - existence and non-emptiness of each `.ts` in `scripts/`.
75
- - `tools/skills.ts hooks` - presence and validity of `@version` (semver) and `@last-reviewed` (ISO date) in each `hooks/*.ts`.
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, tests.ts, mutations.ts, eval.ts, all via tsx)
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