docs: add NEWSTART.md and NEWSTART.llm.md capturing all governance, process, and blueprint for a clean repo restart
Some checks are pending
ci / test (push) Waiting to run

This commit is contained in:
2025-09-17 11:40:15 -05:00
parent 11a611e072
commit 6fa024ddfa
10 changed files with 200 additions and 5 deletions

View File

@@ -5,7 +5,8 @@
- Read `.llm.md` only; write both `.md` and `.llm.md` siblings for collab artifacts.
- Chat ≤5 lines; default “Updated <filepath>…”; no diffs; announce only collab file changes; log details in `docs/devlog/`.
- Quiet shell: avoid `cat`/`sed` outputs; use silent checks; log details to DevLog files.
- Quiet is mandatory (no toggle) for this tool.
- Quiet is mandatory (no toggle) for this tool.
- Tool logging: use quiet wrapper; log to `docs/devlog/tool.log` on failures; no chat output.
- Keep changes minimal and focused; adopt TDD (tests first); require unit/integration tests for all features; consistent style.
- Git: Conventional Commits; branch `main`; optional tags `YYYY-MM-DD-HHMM`.
- Tools: file-first; use `rg`; read ≤250 lines; respect sandbox/approvals; preface grouped commands.

View File

@@ -39,7 +39,8 @@ Note: This is a template copied into generated projects. Customize as needed for
- Keep chat ≤5 lines; no diffs or large pastes.
- Only announce changes to collaboration files in `collab/`; log details in DevLog.
- Quiet shell: avoid streaming file contents/diffs; prefer silent checks and log details to DevLog.
- Quiet is mandatory (no toggle) for this tools workflows.
- Quiet is mandatory (no toggle) for this tools workflows.
- Tool logging: use a quiet wrapper to log to `docs/devlog/tool.log` on failures; keep chat silent.
## Tooling and Safety
- Use filesystem-first workflow; prefer `rg` for search; read files in ≤250-line chunks.