Skip to content

chore: require issue-first workflow, remove plans directory#76

Merged
zacharias-ona merged 1 commit into
mainfrom
chore/issue-first-workflow-and-remove-plans
Apr 15, 2026
Merged

chore: require issue-first workflow, remove plans directory#76
zacharias-ona merged 1 commit into
mainfrom
chore/issue-first-workflow-and-remove-plans

Conversation

@zacharias-ona
Copy link
Copy Markdown
Collaborator

Closes #75

What

Agents sometimes create PRs without a linked issue, blocking the PR Reviewer from merging. The .agents/plans/ directory is redundant — GitHub Issues already serve as plans.

Changes

AGENTS.md:

  • Added issue-first workflow rule: create a GitHub issue with status:in-progress before opening a feat or fix PR
  • Added label safety section: status:backlog is for automation pickup only, status:in-progress for active work
  • Removed plans/active/ and plans/completed/ from project structure and "Where to Find Details"

.agents/conventions.md:

  • Added "PR Workflow" section with issue-first pattern, gh issue create example, and label safety rules

.agents/README.md:

  • Removed plans/ rows from contents table and usage instructions

Deleted:

  • .agents/plans/active/.gitkeep
  • .agents/plans/completed/.gitkeep

Automation conflict analysis

Feature Builder and Bug Fixer both poll for status:backlog issues. The new documentation instructs agents to use status:in-progress when creating issues for work they're already doing, preventing automations from claiming those issues. No automation prompt changes needed — the existing guards are sufficient.

Closes #75

- AGENTS.md: add issue-first rule for feat/fix PRs, document label
  safety to avoid automation conflicts, remove plans/ references
- conventions.md: add PR Workflow section with issue-first pattern
  and label safety guidance
- .agents/README.md: remove plans/ rows
- Delete .agents/plans/ (empty, redundant with GitHub Issues)

Co-authored-by: Ona <no-reply@ona.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
memo Ready Ready Preview, Comment Apr 15, 2026 7:45pm

Request Review

@zacharias-ona zacharias-ona merged commit dc04a55 into main Apr 15, 2026
6 checks passed
@zacharias-ona zacharias-ona deleted the chore/issue-first-workflow-and-remove-plans branch April 15, 2026 19:47
@zacharias-ona
Copy link
Copy Markdown
Collaborator Author

✅ UI verification skipped — no UI files changed in this PR (only .agents/ and AGENTS.md).

@zacharias-ona
Copy link
Copy Markdown
Collaborator Author

⏭️ Post-merge verification skipped — chore: PRs don't affect the live app.

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.

Require issue-first workflow for PRs, remove redundant plans directory

1 participant