@oevery/rsp 3.2.0 → 4.0.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 (68) hide show
  1. package/README.md +25 -17
  2. package/README.zh-CN.md +25 -17
  3. package/dist/chunk-HFSTLCCK.mjs +3968 -0
  4. package/dist/cli.mjs +3510 -2446
  5. package/dist/entry-RIJQ2X46.mjs +1932 -0
  6. package/package.json +32 -19
  7. package/skills/rsp/SKILL.md +42 -68
  8. package/skills/rsp/references/closeout.md +38 -0
  9. package/skills/rsp/references/context-migration.md +22 -0
  10. package/skills/rsp/references/control-outcome.md +5 -0
  11. package/skills/rsp/references/coordination-recovery.md +25 -0
  12. package/skills/rsp/references/coordination-review.md +15 -0
  13. package/skills/rsp/references/coordination.md +59 -0
  14. package/skills/rsp/references/durable-review.md +74 -9
  15. package/skills/rsp/references/focus-continuation.md +13 -0
  16. package/skills/rsp/references/groups-dependencies.md +6 -4
  17. package/skills/rsp/references/response-language.md +13 -0
  18. package/skills/rsp/references/setup-repair.md +37 -7
  19. package/skills/rsp/references/work-model.md +27 -0
  20. package/skills/rsp-commit/SKILL.md +82 -22
  21. package/skills/rsp-commit/references/message.md +34 -0
  22. package/skills/rsp-doc/SKILL.md +65 -0
  23. package/skills/rsp-doc/agents/openai.yaml +3 -0
  24. package/skills/rsp-doc/references/artifact-lenses.md +43 -0
  25. package/skills/rsp-doc/references/release-communication.md +39 -0
  26. package/skills/rsp-doc/references/skill-authoring.md +36 -0
  27. package/skills/rsp-implement/SKILL.md +62 -21
  28. package/skills/rsp-implement/references/diagnosis.md +10 -0
  29. package/skills/rsp-implement/references/finding-resolution.md +21 -0
  30. package/skills/rsp-implement/references/test-first.md +7 -0
  31. package/skills/rsp-review/SKILL.md +44 -46
  32. package/skills/rsp-review/references/code-review.md +23 -7
  33. package/skills/rsp-review/references/document-review.md +25 -8
  34. package/skills/rsp-review/references/release-communication.md +21 -0
  35. package/skills/{rsp-structural-audit/references/structural-lenses.md → rsp-review/references/structural-review.md} +5 -5
  36. package/skills/rsp-shape/SKILL.md +24 -45
  37. package/skills/rsp-shape/references/complex-shaping.md +3 -1
  38. package/skills/rsp-shape/references/deep-clarification.md +4 -4
  39. package/skills/rsp-shape/references/domain-modeling.md +13 -0
  40. package/skills/rsp-shape/references/module-seams.md +13 -0
  41. package/skills/rsp-shape/references/planning.md +42 -0
  42. package/skills/{rsp-design → rsp-shape}/references/reversible-exploration.md +2 -2
  43. package/skills/rsp-verify/SKILL.md +72 -0
  44. package/dist/chunk-JOMFFQRG.mjs +0 -99
  45. package/dist/chunk-JYDEJEM4.mjs +0 -358
  46. package/dist/chunk-SEGJLWRE.mjs +0 -1158
  47. package/dist/chunk-ZORUJTVS.mjs +0 -1967
  48. package/dist/entry-I22OUIW5.mjs +0 -888
  49. package/dist/entry-RG6HREUN.mjs +0 -174
  50. package/rules/rsp-rules.md +0 -47
  51. package/skills/rsp/references/managed-routing.md +0 -44
  52. package/skills/rsp/references/release-operations.md +0 -9
  53. package/skills/rsp-design/SKILL.md +0 -53
  54. package/skills/rsp-design/references/domain-modeling.md +0 -11
  55. package/skills/rsp-design/references/module-seams.md +0 -11
  56. package/skills/rsp-diagnose/SKILL.md +0 -46
  57. package/skills/rsp-manage/SKILL.md +0 -96
  58. package/skills/rsp-manage/references/closeout.md +0 -11
  59. package/skills/rsp-manage/references/interruption-recovery.md +0 -7
  60. package/skills/rsp-manage/references/review-convergence.md +0 -7
  61. package/skills/rsp-release-docs/SKILL.md +0 -77
  62. package/skills/rsp-release-docs/references/convention-discovery.md +0 -65
  63. package/skills/rsp-release-docs/references/evidence-and-surfaces.md +0 -21
  64. package/skills/rsp-release-docs/references/output-contracts.md +0 -97
  65. package/skills/rsp-release-docs/references/publication-lifecycle.md +0 -24
  66. package/skills/rsp-resolve-findings/SKILL.md +0 -61
  67. package/skills/rsp-structural-audit/SKILL.md +0 -71
  68. package/skills/rsp-tdd/SKILL.md +0 -48
@@ -1,77 +0,0 @@
1
- ---
2
- name: rsp-release-docs
3
- description: Draft, audit, finalize, or reconcile evidence-based changelogs, release notes, and migration notes for an explicit release operation.
4
- license: MIT
5
- metadata:
6
- author: oevery
7
- version: "2026.07.26.1"
8
- ---
9
-
10
- # RSP Release Docs
11
-
12
- Build one net-release evidence ledger and project it into repository-owned release surfaces. Git history locates evidence; it is not product truth.
13
-
14
- Follow Core's response-versus-artifact language boundary for all user-visible control narration; when the response language differs, keep exact canonical values only as secondary parenthesized or code-formatted tokens.
15
-
16
- ## Establish authority
17
-
18
- Resolve user scope, audience, language, format, references, and mutation authority first; then nearest project instructions, release-tool configuration, target-artifact conventions, and prior published releases. Higher-precedence evidence wins. Ask one focused question only when an unresolved owner choice materially changes the public result.
19
-
20
- Read [convention discovery](references/convention-discovery.md) when repository, personal, tool, or historical conventions must be located or reconciled. Do not invent configuration or persist preferences without authority.
21
-
22
- A release identity is confirmed only by explicit user instruction or authoritative repository release configuration. Never infer it from semantic-version ordering, prior prereleases, commits, planned prose, or package-manager convention. Until confirmed, keep work version-neutral and do not mutate manifests, target changelog headings, exact-version commands, versioned note paths, or tag comparisons.
23
-
24
- Before continuing, name the range, confirmed version or draft state, audience, surfaces, language, link style, and allowed mutations.
25
-
26
- ## Select one branch
27
-
28
- - **Audit:** inspect fixed release prose and return findings without editing.
29
- - **Draft:** collect and project evidence. While identity can change, keep the ledger transient or use an existing release-fragment owner. Once identity is confirmed, update only authorized surfaces. Formal releases include release notes; update a changelog only when the repository owns one or the user asks; include migration guidance whenever users must act.
30
- - **Finalize for publication:** require confirmed identity and range, completed implementation Change closeout, and an exact clean candidate. An explicit tag, hosted release, registry publication, or equivalent public request must pass this branch even after prose review. Bind `ready` to the exact release commit.
31
- - **Reconcile published release:** observe the published identity and external surfaces, repair only authorized mutable surfaces, and assign immutable discrepancies to a corrective version or owner. Never rewrite a published package or move a tag to manufacture consistency.
32
-
33
- Exactly one branch is active. Give every requested surface one disposition: draft, finalize, reconcile, audit only, not applicable, or blocked by a named decision.
34
-
35
- ## Keep release coordination proportional
36
-
37
- A confirmed mechanical release does not require an RSP Change. Keep the ledger, command progress, authentication state, and publication handoff transient; manifests, changelog, release commit, tag, hosted release, and registry record own durable release history.
38
-
39
- Use an optional Release Change only when material version/range, migration, rollback, security, compatibility, cross-repository/team, multi-stage handoff, recovery, blocker, or acceptance decisions need a persistent owner. Do not create one for a checklist, verification transcript, or prose already owned by release surfaces.
40
-
41
- ## Build evidence before prose
42
-
43
- Inspect the smallest sufficient set: base and target refs; commits and net diff; relevant PRs, issues, Changes, fragments, and release PRs; public API, CLI, configuration, packaging, migration, security, and operator behavior; release surfaces and configuration; fresh verification and known acceptance gaps.
44
-
45
- Use direct consumers and diffs for behavior, work artifacts and public docs for meaning, and commit metadata for navigation. Reconcile disagreements explicitly. Historical verification must name its observed revision or date.
46
-
47
- Read [evidence and surfaces](references/evidence-and-surfaces.md) before drafting the ledger, classifying statement lifetime, or deciding exclusions. Read [output contracts](references/output-contracts.md) before introducing a format, preparing a major/breaking release, or producing multiple surfaces.
48
-
49
- Every relevant commit and work item must map to a net outcome or explicit exclusion. Collapse implementation chronology, omit additions reverted within the range, fold prerelease fixes into final behavior, and exclude internal work unless it changes public behavior, packaging, compatibility, security, operations, or release integrity.
50
-
51
- ## Project distinct surfaces
52
-
53
- - **Changelog:** concise cumulative notable outcomes using the existing categories, or Keep a Changelog categories as fallback. Put breaking changes and required action first.
54
- - **Release notes:** audience-specific narrative led by the most important outcomes, required action, evidenced compatibility and limitations, plus the full range link. Do not merely duplicate the changelog.
55
- - **Migration notes:** identify affected users, ordered actions, changed defaults or removed surfaces, compatibility window, validation, and known rollback/support. Use a separate guide when this would overwhelm the notes.
56
-
57
- Every claim must map to the ledger. Keep terminology aligned while respecting each surface's audience and lifetime.
58
-
59
- ## Finalize the exact candidate
60
-
61
- Read [publication lifecycle](references/publication-lifecycle.md) before a publication handoff or post-publication reconciliation.
62
-
63
- Finalization inspects public release surfaces and package inventory at the exact candidate—not every internal workflow artifact present in the tag. Require version, date, changelog, notes, migration guidance, comparisons, manifests, package inventory, release checks, and lifecycle closeout to agree. Shipped prose must remain true before, during, and after publication; transient publication or authentication state belongs only in the handoff.
64
-
65
- When Git delivery is authorized, implementation Changes remain independently reviewable and versioned shipped surfaces are finalized in a separate release commit. Return the version, immutable candidate ref, required external actions, fresh checks, omissions, and `ready` or `not ready`. `ready` means internally eligible for a separately authorized operation; it is neither publication authority nor evidence of publication.
66
-
67
- ## Protect authority and credentials
68
-
69
- This Skill never executes or grants authority for commit, tag, push, hosted release creation, registry publication, deployment, deletion, approval, or rewriting immutable history. Publication is a separate external operation.
70
-
71
- Treat one-time passwords, browser-auth URLs, device codes, tokens, and token-bearing query strings as credentials. Never retain their values in release prose, Changes, ledgers, logs, summaries, or responses. If a command would expose them to retained output, stop and let the authorized human authenticate in a trusted terminal; resume only with credential-free status.
72
-
73
- ## Return an evidence-complete result
74
-
75
- Before returning, confirm consistent range and identity; ledger coverage or explicit exclusions; claims bounded by evidence; prominent breaking, migration, security, deprecation, and known-limit information; convention-compatible links, dates, headings, language, and terminology; publication-invariant shipped prose; transient state with its owner; credential-free retained output; and edits limited to authorized paths.
76
-
77
- Return the range, branch, changed or audited artifacts, coverage and exclusions, unresolved owner decisions, validation, handoff readiness when applicable, and whether any external action occurred.
@@ -1,65 +0,0 @@
1
- # Convention discovery
2
-
3
- Use this reference when a repository may have personal, project, tool, or historical release conventions. Discover; do not introduce a new configuration file merely to satisfy this Skill.
4
-
5
- ## Authority sources
6
-
7
- Inspect only relevant, non-secret sources:
8
-
9
- 1. Current user instructions, including requested audience, language, tone, links, output paths, and whether edits are allowed.
10
- 2. Applicable instructions, with the nearest project instruction winning over broader host or personal defaults.
11
- 3. Project release documents such as `CONTRIBUTING.md`, maintainer guides, or a documented release checklist.
12
- 4. Existing target artifacts such as `CHANGELOG.md`, `NEWS.md`, release-note templates, upgrade guides, or an in-app What's New source.
13
- 5. Release configuration and package scripts.
14
- 6. Recent published releases and tags.
15
-
16
- Do not scan unrelated home-directory configuration. Do not print tokens, registry credentials, private URLs, authorization headers, or hidden release secrets. When a named config may contain secrets, inspect only the keys needed to identify release behavior. Keep a newly stated preference session-local unless the user explicitly authorizes an existing project or personal instruction owner.
17
-
18
- ## Common configuration signals
19
-
20
- Look for these only when present or relevant:
21
-
22
- - `.github/release.yml`, Release Drafter, or GitHub Release templates;
23
- - release-please manifest/configuration;
24
- - `.changeset/config.json` and changeset fragments;
25
- - Towncrier, Changie, or similar news fragments;
26
- - `cliff.toml`, conventional-changelog, semantic-release, or commit-and-tag-version configuration;
27
- - monorepo package boundaries and per-package changelogs;
28
- - package scripts, CI release workflows, and version files;
29
- - tracker labels such as breaking, feature, fix, skip-changelog, or security.
30
-
31
- Treat generated release notes and automation output as evidence inventories. Human-facing claims still require semantic review.
32
-
33
- ## Adaptation decisions
34
-
35
- Resolve these dimensions independently:
36
-
37
- | Dimension | Evidence to prefer |
38
- | --- | --- |
39
- | Audience | Explicit request, established release surface, prior releases |
40
- | Language | Explicit request, established target artifact, configured effective artifact language, nearest project instruction, prior published releases, conversation |
41
- | Voice | Existing artifact and product terminology |
42
- | Categories | Existing artifact/config; Keep a Changelog only as fallback |
43
- | Version and tags | Confirmed target, manifests, release config, prior tags |
44
- | References | Existing links and tracker policy; generic hierarchy only as fallback |
45
- | Output paths | Existing release owner or explicit path authority |
46
- | Detail | Audience needs, release risk, and existing cadence |
47
-
48
- Personal preferences refine the project format where compatible. Project-owned parsers, schemas, and release contracts win when a stylistic preference would break them. Report the conflict when the user must choose.
49
-
50
- For language specifically, follow Core's response-versus-artifact boundary. An explicit surface-specific request wins. Otherwise preserve an existing target artifact's established language. For a new release artifact, use the configured effective artifact language, then the nearest project or release instruction, prior published releases, and finally the conversation language. Configuration changes never translate an existing release surface by themselves.
51
-
52
- ## Repository shapes
53
-
54
- - **Library or SDK:** emphasize public API, compatibility, deprecation, migration, runtime support, and precise references.
55
- - **Application:** emphasize visible workflows, changed defaults, operator action, rollout, and known limitations.
56
- - **CLI:** emphasize command/flag/config semantics, output contracts, migration, and shell compatibility.
57
- - **Monorepo:** determine the released unit before collecting evidence; avoid mixing unrelated packages.
58
- - **GitHub-Releases-only project:** draft release notes without creating `CHANGELOG.md` unless requested.
59
- - **Fragment-based project:** use accepted fragments as semantic evidence, then verify the net diff and release boundary.
60
-
61
- ## Conflict examples
62
-
63
- - If the user requests Chinese release notes but `CHANGELOG.md` is consistently English, keep the changelog English and draft the release notes in Chinese unless the user explicitly asks to translate both.
64
- - If the user requests commit IDs but prior releases use PR links, preserve PR links and add commit links only for exact provenance unless the user explicitly overrides the project style.
65
- - If a tool requires two synchronized formats, update both from one ledger while preserving each parser's syntax.
@@ -1,21 +0,0 @@
1
- # Evidence and surfaces
2
-
3
- Load this reference before drafting the release ledger, assigning statement lifetime, or deciding exclusions.
4
-
5
- ## Evidence ledger
6
-
7
- Keep a transient table or equivalent notes with: evidence identifiers/links, net user or operator outcome, audience, breaking/deprecation/security/compatibility/migration impact, changelog and release-note dispositions, reference choice, and exclusion or uncertainty owner.
8
-
9
- The ledger is an analysis device, not a new project state store. Persist it only in an existing release-fragment system or explicitly authorized destination. It describes the released net state rather than commit chronology.
10
-
11
- ## Surface lifetime
12
-
13
- - **Shipped surfaces:** package metadata and release communication captured by the tag or package, including README, changelog, repository notes, manifests, and migration guides. Internal workflow records keep their own artifact lifetime. Shipped statements must be publication-invariant: exclude “not yet published,” “available after publication,” pending authentication, unverified registry state, and comparisons ending at `HEAD`.
14
- - **Mutable public surfaces:** hosted release descriptions, safely mutable registry metadata, and other external records. Keep stable narrative aligned with shipped surfaces; add live verification only after observing it.
15
- - **Transient release state:** credentials, authentication, command progress, pending publication, and unverified availability. Keep it in an authorized tracker, temporary ledger, or response handoff—never shipped prose.
16
-
17
- When immutable published content is wrong, preserve it, explain the discrepancy on an authorized mutable surface, and name a corrective version or owner.
18
-
19
- ## References
20
-
21
- Follow repository policy first. Otherwise add a version-level tag or comparison link, prefer PRs for implementation context, issues or tracked work for rationale and migration, and commits when no better semantic anchor exists or exact provenance is required. Links are optional per bullet and must be stable and public; do not expose private tracker identifiers.
@@ -1,97 +0,0 @@
1
- # Output contracts
2
-
3
- Use these as fallbacks. Preserve an established repository format whenever it exists.
4
-
5
- The generic baseline is Keep a Changelog 1.1.0 for cumulative structure and Semantic Versioning 2.0.0 for version meaning. Treat Conventional Commits, forge-generated notes, and label-based categorization as evidence inventories rather than finished prose.
6
-
7
- ## Default changelog shape
8
-
9
- ```markdown
10
- # Changelog
11
-
12
- ## [Unreleased]
13
-
14
- ## [3.0.0] - YYYY-MM-DD
15
-
16
- ### Added
17
-
18
- - Add a user-visible capability. ([#123])
19
-
20
- ### Changed
21
-
22
- - **Breaking:** Change an existing contract. See the [migration guide].
23
-
24
- ### Fixed
25
-
26
- - Prevent an observable failure in a supported workflow. ([abc1234])
27
-
28
- [Unreleased]: https://github.com/OWNER/REPO/compare/v3.0.0...HEAD
29
- [3.0.0]: https://github.com/OWNER/REPO/compare/v2.0.0...v3.0.0
30
- [#123]: https://github.com/OWNER/REPO/pull/123
31
- [abc1234]: https://github.com/OWNER/REPO/commit/abc1234...
32
- [migration guide]: https://example.com/migration
33
- ```
34
-
35
- Use Added, Changed, Deprecated, Removed, Fixed, and Security as fallback categories. Omit empty categories. Do not add an Unreleased section when the established project intentionally does not use one.
36
-
37
- ## Default release-note shape
38
-
39
- ```markdown
40
- # Version 3.0.0
41
-
42
- One short paragraph explaining the release's purpose and who benefits.
43
-
44
- ## Highlights
45
-
46
- - Outcome and benefit, grouped by capability rather than commit.
47
-
48
- ## Breaking changes and migration
49
-
50
- - Who is affected, what action is required, and where to find the full guide.
51
-
52
- ## Other changes
53
-
54
- - Notable improvements and fixes that matter to this audience.
55
-
56
- ## Compatibility and known limitations
57
-
58
- - Supported environments, verified coverage, and explicit non-claims.
59
-
60
- **Full changelog:** https://github.com/OWNER/REPO/compare/v2.0.0...v3.0.0
61
- ```
62
-
63
- Omit inapplicable sections. Prefer three to seven scannable themes for a typical release; group small visible fixes without hiding high-impact items. Include contributors when the established release surface values attribution.
64
-
65
- ## Migration contract
66
-
67
- For each required action, answer:
68
-
69
- 1. Who is affected?
70
- 2. What old behavior or surface changes?
71
- 3. What must they do, in what order?
72
- 4. What compatibility window or deadline applies?
73
- 5. How can they verify success?
74
- 6. What rollback, recovery, or support path exists?
75
-
76
- Keep a short summary in release notes and link a dedicated guide when the procedure is long, conditional, or operationally risky.
77
-
78
- ## Net-release examples
79
-
80
- - Five commits build one new capability: write one outcome.
81
- - A feature is added and reverted before release: omit it.
82
- - A bug is found and fixed before users receive the new feature: fold the final behavior into the feature item.
83
- - An internal refactor changes no public, packaging, security, or operator behavior: exclude it and record the reason in the coverage audit.
84
- - A dependency update changes the minimum runtime or bundled behavior: include the observable compatibility impact, not the dependency housekeeping.
85
-
86
- ## Integrity gate
87
-
88
- Before finalizing, require:
89
-
90
- - complete range coverage with explicit exclusions;
91
- - traceable claims and no inferred readiness;
92
- - archived verification labeled as historical, with a fresh finalization gate when the release range has advanced;
93
- - matching versions, dates, tags, and links;
94
- - visible breaking and migration action;
95
- - no leaked private identifiers or secrets;
96
- - no external publication implied by a draft;
97
- - a diff limited to authorized release artifacts.
@@ -1,24 +0,0 @@
1
- # Publication lifecycle
2
-
3
- Load this reference before finalizing an exact publication candidate or reconciling an observed publication.
4
-
5
- ## Finalization gate
6
-
7
- Require all of the following at the exact candidate:
8
-
9
- - target version agrees across manifests, changelog heading/date, release notes, migration guidance, and exact-version assertions;
10
- - the target changelog entry is not labeled `Unreleased`;
11
- - stable comparisons end at the target tag or immutable ref, not `HEAD`;
12
- - shipped surfaces contain no pending-publication, authentication, or unverified-live-state prose;
13
- - package inventory and release checks are fresh, with omissions named;
14
- - required implementation lifecycle closeout is in the candidate revision and its worktree relationship is explicit.
15
-
16
- Any missing evidence yields `not ready` with the failed gate and owner. A `ready` result identifies the version, immutable candidate ref, required external actions, checks, and omissions without executing them.
17
-
18
- ## Reconciliation
19
-
20
- After publication, observe the tag target, hosted release, registry version/dist-tags, and exact-version consumer command where applicable. Compare them with the finalization handoff and shipped inventory. Update authorized mutable surfaces only from observed state. Mark unknown facts unverified and record immutable drift with a corrective version or owner; never move tags or rewrite packages.
21
-
22
- ## Credential boundary
23
-
24
- Keep authentication values and URLs out of retained output. A human performs any credential-emitting interactive step in a trusted terminal; the handoff records only credential-free required/completed status.
@@ -1,61 +0,0 @@
1
- ---
2
- name: rsp-resolve-findings
3
- description: Resolve one fixed rsp-review report for an RSP-tracked change. Use when the user or a qualified managed goal authorizes disposition, bounded fixes, fresh verification, re-review, or recovery; keep the reviewer report-only and never infer Git or publication authority.
4
- license: MIT
5
- metadata:
6
- author: oevery
7
- version: "2026.07.28.1"
8
- ---
9
-
10
- # RSP Resolve Findings
11
-
12
- Resolve one fixed review report without changing what the reviewer observed. Treat resolution as a bounded correction pass, not a retry loop or a second project lifecycle.
13
-
14
- Render headings, field labels, explanations, and conclusion prose in the language explicitly requested by the user; otherwise follow nearest project instructions, then the conversation language. Treat report and handoff shapes as semantic field order rather than fixed English wording: translate their human-facing labels when the output language differs. Preserve paths, commands, identifiers, WorkRefs, FindingRefs, severity labels, and the dispositions `accepted`, `rejected`, and `needs-clarification` unchanged; when their language differs from the response, retain those dispositions only as secondary exact tokens beside localized narration.
15
-
16
- ## Fix scope and authority
17
-
18
- Require the review report, its fixed comparison or file set, the selected Change and sibling Group Brief when applicable, relevant project authority, and either explicit user permission or Core-confirmed original managed authority for proposed mutation. Read the current worktree and the smallest behavior chain needed to verify each Finding. Preserve unrelated modified, staged, and untracked work.
19
-
20
- Identify a Finding by its report order plus severity, title, and location. Stop if the report, comparison, Change, or Finding identity is missing or conflicting. A report grants investigation only: correction, verification, re-review, Git delivery, publication, deployment, approval, and external actions retain their own authority. Never infer Git or publication authority.
21
-
22
- ## Disposition every finding
23
-
24
- Assign exactly one disposition and concise evidence to every input Finding:
25
-
26
- - `accepted`: current production or document evidence confirms the issue, the intended correction is authoritative, and the fix is inside the selected Change and mutation authority;
27
- - `rejected`: direct evidence disproves the issue or shows that its suggested action is not required by the selected authority; record the evidence and do not edit for it;
28
- - `needs-clarification`: an owner decision, authoritative requirement, reproducible trigger, or safe scope is missing; name the required input and do not edit for it.
29
-
30
- Do not accept feedback for politeness, reject it from intuition, or silently reinterpret an ambiguous Finding. When one correction covers multiple accepted Findings, retain each disposition and point them to the shared fix.
31
-
32
- ## Fix accepted findings
33
-
34
- In one resolution pass, implement the smallest complete correction for accepted Findings only. Add or adjust focused tests when the corrected behavior or failure contract requires them. Do not modify `rsp-review`, the original report, or unrelated findings to make the result appear clean.
35
-
36
- After the last relevant edit, run fresh verification for the affected behavior and the selected Change. A failed, unavailable, stale, or omitted check cannot close an accepted Finding. If a check exposes another defect, return it as evidence; do not begin an automatic retry loop.
37
-
38
- Require a fresh fixed-scope re-review before claiming resolution. Return a re-review request containing the original comparison, selected authority, post-fix file set or immutable comparison, implementation summary, dispositions, and verification evidence. The re-review remains report-only. On resume with its report, correlate original Findings as resolved or remaining and return any new Finding as unresolved input to Core. Resolve Findings never self-loops. Only qualified Manage may classify an in-scope `accepted` Finding as `correction-needed` and re-enter another bounded pass under the original managed authority and its separate convergence limit; standalone work requires new authority.
39
-
40
- ## Handoff and recovery
41
-
42
- When work stops before a clean re-review, return Core's compact artifact-scoped continuation with review state embedded in the shared fields:
43
-
44
- ```md
45
- ## <localized Review Resolution Handoff heading>
46
- - <localized WorkRef label>: <selected Change>
47
- - <localized Authority label>: <project, Change, fixed report, and comparison pointers>
48
- - <localized Current state label>: <review input, FindingRef dispositions, and re-review status>
49
- - <localized Changed artifacts label>: <reviewed and changed paths, or none>
50
- - <localized Fresh verification label>: <command and result, or pending reason>
51
- - <localized Blockers label>: <unresolved FindingRefs and required owner input, or none>
52
- - <localized Next action label>: <smallest bounded action and owner>
53
- ```
54
-
55
- The handoff contains authoritative pointers, not project truth. Return it in the response unless the user explicitly authorizes a path; never create a hidden receipt or persistent run state. It is not durable truth or a second state store. Exclude secrets, full logs, and duplicated Change text.
56
-
57
- To recover, reopen every authority pointer, confirm the WorkRef and comparison still identify the intended scope, inspect current worktree drift, and revalidate claimed verification. Mark stale evidence pending instead of trusting the handoff. Continue only the named pass; host threads, agents, hooks, or proprietary resume features are optional and never required.
58
-
59
- ## Return ownership
60
-
61
- Report the disposition table, changed artifacts, preserved unrelated work, fresh verification, re-review status, and the handoff when anything remains. Name `correction-needed` only when Core supplied a qualified managed continuation; it is not an external blocker or durable Change state. Resolution is complete only when every Finding has a supported disposition, every accepted Finding has a verified correction, the fresh fixed-scope re-review is clean, and no `needs-clarification` input remains. Never claim archive, commit, push, publication, deployment, or approval.
@@ -1,71 +0,0 @@
1
- ---
2
- name: rsp-structural-audit
3
- description: Audit one explicitly bounded repository or subtree for evidence-backed structural risks before implementation work is selected. Use for report-only discovery of ownership, dependency, production-path, change-amplification, or verification mismatches; do not use for security, performance, dependency, framework, style, or production-readiness audits.
4
- license: MIT
5
- metadata:
6
- author: oevery
7
- version: "2026.07.28.1"
8
- ---
9
-
10
- # RSP Structural Audit
11
-
12
- Discover the few structural risks worth considering next. Return a report only.
13
-
14
- ## Trigger and input
15
-
16
- Use this Skill when the user wants to discover material structural risks in an existing codebase before a Change, fixed review scope, or bounded design question exists. Require one explicit repository or subtree boundary and honor narrower user questions and exclusions. An RSP Change is not required; if one is focused, use it only when it matches the requested scope.
17
-
18
- Read nearest project instructions and context first. Then inspect only the smallest useful chain of entry points, direct callers or consumers, state and data owners, relevant configuration, and focused tests. Treat implementation, tests, comments, and directory structure as evidence rather than product authority.
19
-
20
- Do not substitute this audit for security, performance, dependency, framework, style, production-readiness, or speculative cleanup work. Return that mismatch and the required specialist owner instead.
21
-
22
- ## Authority
23
-
24
- The user owns the audit boundary and requested outcome. Project instructions, Specs, and decisions own established constraints. A focused Change may provide intent or scope but grants no additional mutation authority.
25
-
26
- This Skill owns only its response report. It never modifies project code, tests, configuration, documentation, RSP artifacts, focus, lifecycle state, Git state, or external systems. It does not create a Change, choose product intent, design a solution, apply a fix, or invoke another Skill.
27
-
28
- ## Action and verification
29
-
30
- After scope and authority are fixed, read [structural audit lenses](references/structural-lenses.md) and select only the lenses relevant to evidence already encountered. Trace concrete owners and live paths; do not scan every directory or apply every lens mechanically.
31
-
32
- Qualify a finding only when exact repository evidence establishes a reachable trigger, a realistic impact, and the implicated ownership or behavior chain. Verify a seam-dependent finding by naming the direct production consumer and confirming whether its actual callee reaches or bypasses the seam. Compare focused tests or other verification evidence with that same live path when the finding depends on claimed coverage.
33
-
34
- Report the smallest unresolved shaping or design question as `Next owner`. Route solution alternatives, seam recommendations, and reversible probes to `rsp-design`; do not develop them inside this audit.
35
-
36
- Do not infer a finding from directory names, pattern matching, code size, framework taste, a generic checklist, or an isolated abstraction without a demonstrated downside. Prefer no finding to a weak finding. Stop inspecting when the requested boundary has enough evidence for at most five material findings, no qualifying finding remains, or further confidence requires authority or evidence outside the boundary.
37
-
38
- ## Output
39
-
40
- Render headings, field labels, explanations, and conclusions in the language explicitly requested by the user; otherwise follow nearest project instructions, then the conversation language. Treat the shape below as semantic field order rather than fixed English wording, while preserving paths, severity labels, confidence values, and the result values `findings`, `clean`, and `scoped uncertainty`; when their language differs from the response, retain those values only as secondary exact tokens beside localized narration.
41
-
42
- Return findings ranked by material impact, then confidence. Emit at most five and use this shape:
43
-
44
- ```md
45
- ## Audit scope
46
- - Boundary: <repository or subtree>
47
- - Authority: <instructions, constraints, and material gaps>
48
- - Inspected: <entry points and smallest behavior chains>
49
- - Excluded: <explicit exclusions and unsupported specialist audits>
50
-
51
- ## Findings
52
- ### [P1-P3] <structural risk>
53
- - Lens: <ownership | dependency | production path | change amplification | verification>
54
- - Evidence: <exact paths and concrete chain>
55
- - Trigger: <reachable condition>
56
- - Impact: <real consequence>
57
- - Confidence: <high | medium | low>
58
- - Next owner: <smallest shaping or design question, or user decision>
59
-
60
- ## Coverage
61
- - <checked paths, unresolved uncertainty, and unobserved runtime behavior>
62
-
63
- ## Result
64
- <findings | clean | scoped uncertainty, with the smallest next action>
65
- ```
66
-
67
- Use `clean` when the inspected boundary contains no evidenced structural risk. Use `scoped uncertainty` when missing authority, inaccessible evidence, or an unsafe runtime requirement prevents judgment; name exactly what is missing and its owner. Do not manufacture advice to fill the report.
68
-
69
- ## Stop
70
-
71
- Stop before auditing when the boundary or owner intent is materially ambiguous. Stop during inspection when evidence requires credentials, an unsafe or destructive probe, production side effects, mutation, or material expansion beyond the explicit boundary. Return the evidence collected, the unverified claim, and one smallest next action. Never continue into shaping, design, implementation, review, archive, Git delivery, publication, deployment, or approval.
@@ -1,48 +0,0 @@
1
- ---
2
- name: rsp-tdd
3
- description: Drive one clear testable behavior owned by a selected RSP Change through observed RED, minimal GREEN, safe REFACTOR, and fresh verification. Use when test-first evidence is the selected next action; return unexplained failures to diagnosis and all results to the same Change.
4
- license: MIT
5
- metadata:
6
- author: oevery
7
- version: "2026.07.24.1"
8
- ---
9
-
10
- # RSP TDD
11
-
12
- Implement one clear behavior test-first and return evidence to its selected Change. Follow Core's response-versus-artifact language boundary for all user-visible control narration; when the response language differs, keep exact canonical values only as secondary parenthesized or code-formatted tokens.
13
-
14
- ## Establish the cycle
15
-
16
- Require one selected, ready Change, clear observable behavior, test and production mutation authority, and an executable focused check. Read project authority, current worktree state, and the smallest owning production/test seam.
17
-
18
- Stop when behavior or acceptance is unclear, mutation authority is missing, an existing symptom has an unexplained cause, the execution environment is unavailable, or a baseline failure cannot be separated. Return the same Change, evidence, and one needed next action.
19
-
20
- ## RED
21
-
22
- Add the smallest focused test at the real owning seam. Run it before production mutation and observe the expected missing or incorrect behavior.
23
-
24
- RED is not a syntax, fixture, environment, or unrelated baseline failure. A passing test disproves the premise; refine it or stop without production mutation. An unexplained failure returns to diagnosis, not a guessed regression test.
25
-
26
- ## GREEN
27
-
28
- Make the minimum production change for GREEN, preserve scope, and rerun the same command. An unexplained failure returns to diagnosis without speculative widening.
29
-
30
- ## REFACTOR
31
-
32
- Refactor only after GREEN for a concrete local improvement; rerun the focused check. Otherwise skip it.
33
-
34
- ## Retain or remove the test
35
-
36
- Keep the test only when it protects observable behavior or a real boundary, adds distinct future confidence beyond existing checks, avoids implementation-detail coupling or duplicate coverage, and has proportionate maintenance cost. A user, Change, or project requirement to retain the test remains authoritative.
37
-
38
- Otherwise treat it as a disposable probe: remove it before completion, verify that no disposable fixture or helper remains, and run the cheapest decisive existing check against the final production state. A removed probe is process evidence, not final verification; when automation is insufficient, record applicable manual or environment evidence.
39
-
40
- ## Verify and return
41
-
42
- After cleanup, run fresh required Change checks and narrow risk checks. Failure or unavailability cannot support completion. Update Tasks and Verify with final decisive evidence, omissions, and unresolved risk rather than a chronological test transcript; keep unresolved issues in Blockers.
43
-
44
- Return to the same selected Change with WorkRef, final state, artifacts, fresh checks, omissions, Tasks, Blockers, and one next action; do not create parallel lifecycle state or recursively invoke another Skill.
45
-
46
- When work remains, use Core's compact continuation fields in order: `WorkRef`, `Authority`, `Current state`, `Changed artifacts`, `Fresh verification`, `Blockers`, and `Next action`. Reopen authority, inspect drift, and refresh verification before resuming; continuation is not durable truth.
47
-
48
- Git staging, commit, push, publication, deployment, review, archive, and approval remain separate actions requiring their own authority.