|
1 | 1 | # Agent Instructions |
2 | 2 |
|
3 | | -This project uses **bd** (beads, see https://github.com/steveyegge/beads) for issue tracking. Run `bd onboard` to get started. |
4 | | - |
5 | | -> Note: `bd` can be installed via `brew install steveyegge/beads/bd` if necessary. |
6 | | -
|
7 | | -## Quick Reference |
8 | | - |
9 | | -```bash |
10 | | -bd ready # Find available work |
11 | | -bd show <id> # View issue details |
12 | | -bd update <id> --status in_progress # Claim work |
13 | | -bd close <id> # Complete work |
14 | | -bd sync # Sync with git |
15 | | -``` |
| 3 | +**CRITICAL RULES:** |
| 4 | +- NEVER push directly to the `main` branch |
16 | 5 |
|
17 | 6 | ## SWC Plugin |
18 | 7 |
|
19 | 8 | When modifying the SWC compiler plugin (`packages/swc-plugin-workflow`), you must also update the specification document at `packages/swc-plugin-workflow/spec.md` to reflect any changes to the transformation behavior. |
20 | | - |
21 | | -## Landing the Plane (Session Completion) |
22 | | - |
23 | | -**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds. |
24 | | - |
25 | | -**MANDATORY WORKFLOW:** |
26 | | - |
27 | | -1. **File issues for remaining work** - Create issues for anything that needs follow-up |
28 | | -2. **Run quality gates** (if code changed) - Tests, linters, builds |
29 | | -3. **Update issue status** - Close finished work, update in-progress items |
30 | | -4. **PUSH TO REMOTE** - This is MANDATORY: |
31 | | - ```bash |
32 | | - git pull --rebase |
33 | | - bd sync |
34 | | - git push |
35 | | - git status # MUST show "up to date with origin" |
36 | | - ``` |
37 | | -5. **Clean up** - Clear stashes, prune remote branches |
38 | | -6. **Verify** - All changes committed AND pushed |
39 | | -7. **Hand off** - Provide context for next session |
40 | | - |
41 | | -**CRITICAL RULES:** |
42 | | -- Work is NOT complete until `git push` succeeds |
43 | | -- NEVER push directly to the `main` branch |
44 | | -- NEVER stop before pushing - that leaves work stranded locally |
45 | | -- NEVER say "ready to push when you are" - YOU must push |
46 | | -- If push fails, resolve and retry until it succeeds |
0 commit comments