Skip to content

Improve issue and epic planning guidance - #19

Merged
vitormattos merged 1 commit into
mainfrom
feat/issue-epic-planning-quality
Oct 7, 2026
Merged

vitormattos merged 1 commit into
mainfrom
feat/issue-epic-planning-quality

Conversation

@vitormattos

Copy link
Copy Markdown
Member

Summary

Improve the create-issues-and-epics skill to cover progressive epic decomposition, native GitHub relationship ownership, UX/prototyping expectations, product documentation as part of done, external GitHub reference hygiene, and AI-specific planning boundaries.

Why

Recent LibreSign planning exposed recurring gaps that should be handled consistently by the reusable skill rather than rediscovered per feature.

Main changes

  • Treat native GitHub parent/sub-issue and blocking relationships as authoritative.
  • Add progressive elaboration and downstream epic handoff guidance.
  • Require UX research/prototyping for new or material interaction changes.
  • Treat user/admin documentation as a feature deliverable rather than an implementation diary.
  • Avoid noisy cross-references to external GitHub issues/PRs used only as research.
  • Add a focused AI planning reference covering human authority, trust boundaries, policy, provider ownership, UX, testing, and deferred platform metadata.

Validation

The commit was created with DCO and cryptographic signing. Local repository checks could not be run because the execution environment cannot resolve GitHub for cloning; CI should run the repository's normal unittest and reuse lint checks.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos merged commit 90ed73c into main Oct 7, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant