When I have more than two terminal instances open, I expect to see two quick action icons when hovering: one for split, one for kill, similar to how VSCode or Cursor handle it.
Is there an option to enable this, or am I missing something?
When I have more than two terminal instances open, I expect to see two quick action icons when hovering: one for split, one for kill, similar to how VSCode or Cursor handle it.
Is there an option to enable this, or am I missing something?
A globally reusable operational rule set for AI development teams. No project assumptions. No file paths. Pure principles + universal workflows.
Take the correct architectural path, never the shortcut.
Prefer clean designs over quick fixes
Avoid wrappers, shims, indirection unless truly necessary
Leave the codebase better than you found it
Future teams inherit your decisions — choose debt-free solutions
Good > Fast. Always.
Every project must define one canonical location for:
Plans
Architecture documents
Team logs
Questions
Phase definitions
Rule: All planning and coordination must happen in that SSOT location. Never fragment planning across multiple places.
Every distinct AI conversation = one team.
Determine highest existing team number
Your number = highest + 1
Team ID is permanent for the lifetime of the conversation
Create a .teams/TEAM_XXX_<summary>.md log file.
When modifying code:
// TEAM_XXX: Reason for change
This ensures long-term traceability.
Every team must:
Read the main project overview
Read the current active phase
Check recent team logs
Check open questions
Claim a team number and create your team file
Ensure all tests pass before making changes
Only then begin implementation
Every project must define a baseline output for critical behavior (snapshots, reference outputs, golden files, fixtures, deterministic logs, etc.).
Before modifying any behavior-critical logic:
Run baseline tests — they must pass
Make changes
Re-run baseline tests
If results differ → this is a regression → fix it
Never modify baseline data unless the USER explicitly approves.
Favor clean breaks over compatibility hacks.
Move or rename the type/function
Let the compiler fail
Fix import sites one by one
Remove temporary re-exports or legacy names
If you are writing adapters to “keep old code working,” stop — fix the actual sites.
Remove:
Unused functions
Unused modules
Commented-out code
“Kept for reference” logic (use git history instead)
The repository must contain only living, active code.
When splitting large modules:
Each module owns its own state
Keep fields private — expose intentional APIs
Avoid deep relative imports
Keep file sizes human-readable (< 1000 lines; < 500 preferred)
Organize by responsibility, not convenience
If ANY of the following occur:
A decision is ambiguous
Requirements conflict
Plans seem incomplete
Something feels “off”
Create a question file under .questions/ and ask the USER.
Never guess on major decisions.
While you still remember the state:
Perform as much aligned work as possible
Don’t stop mid-task if more progress is obvious
Minimize context re-initialization for next teams
If a task grows too large: split it into sub-tasks within your team directory.
Every team must:
Update their team file with progress
Ensure project builds
Ensure all tests pass
Ensure baseline (golden) tests pass if applicable
Document remaining problems, blockers, or next steps
Write handoff notes
[ ] Project builds cleanly [ ] All tests pass [ ] Behavioral regression tests pass (if applicable) [ ] Team file updated [ ] Remaining TODOs documented
Any incomplete work must be:
TODO(TEAM_XXX): what is missing
Add corresponding items with file + line + description.
This guarantees future teams know what remains.
| Concept | Description |
|---|---|
| SSOT | The single place where planning/logs/phases live |
| Team Files |
Each team writes logs in .teams/TEAM_XXX_*
|
| Questions |
.questions/TEAM_XXX_*
|
| Current Phase | Defines what teams should be working on |
| Regression Tests | Any project-defined baseline outputs |
| TODO.md | Global tracking of incomplete tasks |