Skip to content

P2: Aggregate scattered concept definitions ([DEFERRED], /sprint-close, etc.) #37

@ramdhanyk

Description

@ramdhanyk

Source: 2026-04-20 multi-expert AADM audit. Docs-UX auditor.

Problem

Definitions for [DEFERRED], /sprint-close, Satisfies: chain, etc. are scattered:

  • [DEFERRED] appears in START-HERE (rule, no definition), handbook (mentioned, no definition), and TASKS template (one-line definition + example).
  • "What does /sprint-close actually run" is listed differently in README (5 things), START-HERE (4 things), handbook §1.5, and method doc line 415.

A cold-read for either question requires bouncing 3+ docs.

Fix

Anchor all concept definitions in GLOSSARY.md (from #11). Everywhere else links to it instead of restating.

Acceptance

Cold-read for "what's a [DEFERRED] entry?" returns a complete answer in one click. Same for "what does /sprint-close run?"

Depends on

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium — adoption ergonomics and docs surfaceaudit-followupFrom the 2026-04-20 multi-expert AADM audit

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions