Skip to content

refactor: optimize config/doctor/status — PMRP->appendix, schema->bullets #92

@JFK

Description

@JFK

Problem

commands/config.md (379), commands/doctor.md (471), and commands/status.md (192) have ~660 tokens of compressible prose, mostly dense procedures and pseudo-XML that read better as tables/bullets.

Scope (CTO/Explore review 2026-06-13)

  • doctor.md: move the 85-line Plugin Metadata Resolution Procedure bash (~doctor.md:203-287) to an appendix/reference, keep a ~20-line summary inline.
  • status.md: convert the review-block schema pseudo-XML <if/> branching (~status.md:48-97) to three bullet lists (v2 fields / v1 fields / synthesis rules).
  • config.md: turn the 3-layer output-language policy (~config.md:13-26) into a 2x3 table; consolidate the repeated review.provider/review.model prose around its table (~config.md:49-70).

Acceptance criteria

Depends on

#1.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions