Skip to content

Commit 6531340

Browse files
committed
docs: scope github issue guidance for live ops
1 parent 61c852c commit 6531340

1 file changed

Lines changed: 17 additions & 10 deletions

File tree

AGENTS.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,14 +29,15 @@ If something behaves unexpectedly (a test fails for unclear reasons, a build bre
2929

3030
Quick lookup — find your situation, follow the required actions:
3131

32-
| Situation | Do this |
33-
| -------------------------- | ------------------------------------------------------------- |
34-
| First time / fresh clone | `nvm use``npm ci``npm run build` |
35-
| Changed any `.ts` file | `npm run build && npm run build:test` |
36-
| Running tests | `npm run test:cli` |
37-
| Added feature or fixed bug | Write a test → build → run tests |
38-
| Installing a dependency | `nvm use` first, then `npm install ...` |
39-
| Before committing | Build passes, all tests pass |
32+
| Situation | Do this |
33+
| ----------------------------- | ------------------------------------------------------------- |
34+
| First time / fresh clone | `nvm use``npm ci``npm run build` |
35+
| Changed any `.ts` file | `npm run build && npm run build:test` |
36+
| Running tests | `npm run test:cli` |
37+
| Added feature or fixed bug | Write a test → build → run tests |
38+
| Installing a dependency | `nvm use` first, then `npm install ...` |
39+
| Routine node/community config | Perform the requested live operation → verify → summarize; no GitHub issue unless explicitly requested |
40+
| Before committing | Build passes, all tests pass |
4041

4142
## Stack
4243

@@ -66,14 +67,20 @@ src/
6667
└── index.ts # package entry point
6768
```
6869

69-
## Feature Implementation Workflow
70+
## GitHub Issues
7071

71-
When the user gives a prompt to implement a feature:
72+
When the user gives a prompt to implement a feature or bug fix in this repository's codebase:
7273

7374
1. **MUST** create a GitHub issue for the feature before starting work (`gh issue create`).
7475
2. **MUST** keep the issue updated with the current plan and progress as work proceeds.
7576
3. **MUST** ask the user whether to close the issue after the feature is fully implemented and verified — do not close it automatically or via `Closes #N` in commit messages.
7677

78+
Routine live operations are not repository feature work:
79+
80+
- **MUST NOT** create GitHub issues for routine live-node operations, community/board configuration changes, data updates, support tasks, or private infrastructure administration unless the user explicitly asks for one.
81+
- **MUST** ask before creating any public GitHub artifact when a task could be interpreted as either repository work or live operations.
82+
- **MUST NOT** include private infrastructure details, secrets, API keys, or user-specific operational data in GitHub issues, comments, PRs, or commit messages.
83+
7784
## Core MUST Rules
7885

7986
### Environment Setup

0 commit comments

Comments
 (0)