Skip to content

docs(issues): add #1771 spec and enforce manual verification workflow#1772

Merged
josecelano merged 3 commits into
torrust:developfrom
josecelano:1771-spec-first-pr-workflow
May 13, 2026
Merged

docs(issues): add #1771 spec and enforce manual verification workflow#1772
josecelano merged 3 commits into
torrust:developfrom
josecelano:1771-spec-first-pr-workflow

Conversation

@josecelano
Copy link
Copy Markdown
Member

Summary

This PR intentionally contains only issue/spec workflow documentation updates so they can be reviewed and merged before implementation starts.

What changed

  • Added and opened issue spec #1771
  • Updated EPIC Overhaul clients #669 to include the new pending sub-issue/spec
  • Clarified spec-first PR workflow for complex issues
  • Strengthened templates and create-issue skill to require:
    • automatic checks after implementation (linter all, relevant tests, pre-push where applicable)
    • manual verification scenarios with status and evidence tracking
    • post-implementation acceptance criteria review

Why

For complex issues, merging the issue spec first improves visibility and allows review of scope/acceptance criteria before code changes.

Manual verification was frequently omitted by agents; templates/skill now make it an explicit required step.

Scope of this PR

Documentation/spec process changes only. No production code changes.

@josecelano
Copy link
Copy Markdown
Member Author

ACK 56e0b1a

@josecelano josecelano merged commit 7cdc882 into torrust:develop May 13, 2026
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