markdowntown-bd

Beads (bd) issue workflow and repo operations for markdowntown. Use when creating bd tasks, updating status, adding dependencies, running required tests, committing, and pushing to main.

markdowntown-bd

Core workflow

Clear stale work: node scripts/bd-reset-stale.mjs --hours 4.
Pick work: npx bd --no-daemon ready --json.
Claim task: npx bd --no-daemon update <id> --status in_progress --json.
Read task: npx bd --no-daemon show <id> --json.
Implement changes and run required tests.
Commit and push to main after tests pass.
Close task: npx bd --no-daemon close <id> --reason "Implemented" --json.
Commit .beads/issues.jsonl updates with code changes.
At session end: npx bd --no-daemon sync.

Guardrails

Always use --no-daemon and --json with bd commands.
Never leave tasks in in_progress if stopping work.
Always run compile, lint, and unit tests before committing.
Push to main after each completed task.
Avoid destructive git commands unless explicitly requested.
Never paste secrets (tokens, keys, credentials) into issues, commits, or logs.

References

docs/BEADS.md
docs/DEV_ONBOARDING.md
codex/skills/markdowntown-bd/references/beads.md
codex/skills/markdowntown-bd/references/release.md