docs: add work tracking guidance

This commit is contained in:
Wilson Freitas
2026-09-01 21:03:38 -03:00
parent 5f1e0f411d
commit 1ac40a3331
+13
View File
@@ -20,6 +20,19 @@ languages, but may also identify runtimes, protocols, interfaces, data types, or
4. `.github/workflows/build.yml` runs the parser and generator, then deploys 4. `.github/workflows/build.yml` runs the parser and generator, then deploys
`site/` to GitHub Pages. `site/` to GitHub Pages.
## Work Tracking and Planning
- Linear is the system of record for issues, prioritization, specifications,
designs, and implementation plans.
- Manage GitHub-originated issues through their synced Linear issues. Do not
create a second internal tracker for the same work.
- Store each specification, design, and implementation plan as a Linear
document attached to the corresponding Linear issue. Do not add task-specific
planning documents to the repository.
- Keep repository documentation for durable project and user documentation only.
- GitHub remains the public contribution surface for pull requests and public
issue discussion; use Linear for internal status, priority, and planning.
## Commands ## Commands
```bash ```bash