Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

feat(planning): make plans reviewable in a minute with behaviour-first summaries and code-shape views

Aperta
  • Qualcosa non va?
#6,927 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
15/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
html, markdown
Ambito
devtools, documentation

Direzione di ricerca

Start with PLAN.md and the /visualization:visualize code-shape views, then with the /planning:plan arbiter for Q12. This is not a first-timer task: it is blocked by #6926 and #6924, and Q12-Q14 are unresolved and reserved for the maintainer. Done means the issue is re-decomposed into smaller slices once the plan exists and the acceptance criteria are met.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

needs-human priority: low

Parent

Refs #6917

What to build

Make a plan reviewable in a minute. PLAN.md stays the record; HTML is only a view of it.

  • PLAN.md opens with a behaviour-first summary, split by behaviour rather than file, layer or order; its claims seed decompose's slices.
  • Plans use /visualization:visualize's code-shape views (call trees, file trees, diffs over them) with @ path:line anchors, readable in a terminal.
  • The plan view is generated from PLAN.md, with links to the Brief, decisions and acceptance criteria.
  • Later: mockups and state machines in the view; word budgets for plan prose.

This is too large for one session: re-decompose it once its plan exists, after the deferred questions are settled:

  • Q12: which visual components ship, and when (arbiter: /planning:plan)
  • Q13: prose standard for plans, STE or our own writing rules (user-reserved)
  • Q14: may answers given in an HTML plan view write back into PLAN.md (user-reserved)

Key interfaces

None

Acceptance criteria

  • PLAN.md opens with a behaviour-first summary
  • Plans use the visualize code-shape views with @ path:line
  • The plan view is generated from PLAN.md, linking the Brief, decisions and acceptance criteria
  • Q12, Q13 and Q14 are answered before the visual work is sliced
  • The PR body carries Refs: #6917

Out of scope

  • HTML as the record (the rendered-views convention stays)
  • Any dependency on html-plan's runtime

Blocked by

  • #6926
  • #6924
Lingua principale
Shell
Stelle
22
Fork
2
Merge medio
8h 27m
PR unite (30g)
957

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di melodic-software/claude-code-plugins

Tutte le issue di melodic-software/claude-code-plugins

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.