Skip to content

codebase-health/audit: Boundary routes to the sibling drift lanes #3810

Description

@kyle-sexton

Parent

Refs #3803

Agent Brief

Type: Feature
Summary: The codebase-health audit skill's Boundary routes an operator to the sibling drift lanes instead of leaving them undiscoverable.

Current behavior:
The codebase-health audit skill covers doc, config, code, and architecture drift. Seven sibling skills each own a different drift dimension, and nothing in the audit skill names them. An operator who reaches this skill has no path to the others.

Desired behavior:
The audit skill's Boundary section names each sibling drift lane with one line stating what that lane owns:

  • the review plugin's doc-drift detector
  • the session-flow reanchor skill
  • the discipline recheck-against-upstream skill
  • the provenance audit skill
  • the claude-config audit skill
  • the instruction-placement delta skill
  • the overengineering delta skill

Every reference is presence-gated: the text must read correctly whether or not the referenced plugin is installed, and must not assert that an absent skill is available. The skill's listing entry stays within the per-skill listing-entry cap; router detail belongs in the body, not in the description.

Key interfaces:

  • The skill's Boundary section — gains one line per sibling lane.
  • The skill's frontmatter description — unchanged in size class; must stay under the listing-entry cap.

Acceptance criteria:

  • The Boundary section names all seven sibling drift lanes, each with one line on what it owns.
  • Every sibling reference is presence-gated in its wording.
  • /skill-quality:check passes for the codebase-health audit skill, including the listing-entry cap check.
  • markdownlint passes on the changed files.
  • The codebase-health plugin version is bumped per repo convention.
  • The plugin README and any reference doc listing the plugin's skills reflect the change.

Out of scope:

  • Changing what the audit skill detects or how it reports.
  • Editing any of the seven sibling skills.
  • Adding a router to any other skill.

Blocked by

None

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.priority: needs-triageDefault until a priority tier is assigned.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions