Instruction file imported from afri-bit/candb-studio (
.cursor/rules/github-first-workflow.mdc). Copyright stays with the author.
GitHub-first workflow
Intent lives on GitHub in this repo (afri-bit/candb-studio). Do not invent a different problem than the issue states.
Intake
| Work | Start | Artifact |
|---|---|---|
| Idea / question / RFC | Discussion | Promote to an issue when actionable |
| Feature | Issue (enhancement) |
specs/NNN-name/ when it adds capability |
| Bug / small fix | Issue (bug) |
Usually no spec |
| Durable design | ADR issue | docs/adr/NNNN-title.md |
| Implementation | Pull request | Fixes #<n> + spec/ADR links |
Guide: docs/workflow/README.md. ADRs: docs/adr/README.md.
When implementing from an issue
- Read the full issue body (acceptance criteria, out of scope, sample
.dbc). - Use
/from-issueif the user pointed at an issue. Otherwise follow the same classification. - Features with
needs-specor new user-visible behavior: Speckit (/speckit.specify→ plan → tasks → implement) using the issue text as input. - Stay in scope. New ideas → new issue or discussion, not extra code.
- Comment on the issue when you add a spec path, ADR path, or PR URL.
- Constitution (
.specify/memory/constitution.md) overrides ad-hoc process.
Do not
- Open issues or PRs on a different remote than
candb-studio. - Skip tests for behavior changes.
- Treat chat history as the spec when a GitHub issue exists.