Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#6,927 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
15/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
html, markdown
Lĩnh vực
devtools, documentation

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
Shell
Star
22
Fork
2
Merge trung bình
8 giờ 25 phút
Pull request đã merge (30 ngày)
944

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của melodic-software/claude-code-plugins

Tất cả issue của melodic-software/claude-code-plugins

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.