docs: migrate work tracking to Redmine system of record

Replace STATUS.md checklists with a Redmine ticket index. All work
status, completion tracking, and issue management now lives in Redmine
(version: Potential to Kinetic Ready, due 2026-09-30). AGENTS.md gains
a Redmine Tracking Policy section with rules for ticket references,
closing procedures, and STATUS.md's new read-only role.
This commit is contained in:
2026-08-06 11:24:48 -05:00
parent 33b5c76bec
commit 317a98b9b1
3 changed files with 99 additions and 216 deletions
+30 -6
View File
@@ -1,8 +1,9 @@
# Agent Guidelines
**Top-level files:** [`README.md`](README.md) (project overview),
[`STATUS.md`](STATUS.md) (living status, agent-maintained),
[`docs/docmap.md`](docs/docmap.md) (documentation index). Everything else
[`STATUS.md`](STATUS.md) (ticket index + infra summary),
[`docs/docmap.md`](docs/docmap.md) (documentation index). All work is
tracked in [Redmine](https://projects.knownelement.com). Everything else
lives in subdirectories.
## Repository Layout
@@ -54,12 +55,34 @@ vendor/ Vendored KNELShellFramework
justification. A script that emits any diagnostic is a protocol violation.
Non-bash scripts (PHP with `.sh` shebang `#!/usr/bin/php`, etc.) are exempt.
## Redmine Tracking Policy
**Redmine is the system of record for all work.** Do not track status,
checklists, or TODOs in repo files. Use Redmine tickets instead.
- **URL:** https://projects.knownelement.com
- **Version:** Potential to Kinetic Ready (due 2026-09-30)
- **Project:** Known Element Enterprises - Technology & Facility Services (id 55)
### Rules
1. **Every piece of work** (feature, fix, deployment, config change) gets a
Redmine ticket. If one doesn't exist, create it.
2. **Reference tickets in docs and commits** using `[#NNN]` notation.
Example: `[#367] Rebuilt k3s control plane after cnode wipe`.
3. **When work completes**, update the ticket: set done ratio to 100%,
add a note describing what was done and where the code lives, then close.
4. **STATUS.md is a read-only snapshot** — it contains a ticket index and
infrastructure summary only. Do not add checklists or status items.
5. **Link code to tickets** — ticket descriptions and notes should reference
the relevant file paths in this repo (e.g., `dcinfra/ups/`).
## Automatic Gardening Protocol
**Docs and code must be kept in sync.** After any work session, an agent MUST:
1. **Update [`STATUS.md`](STATUS.md)** — reflect completed work, new issues,
changed infrastructure state. This file is human read-only; agents own it.
1. **Update [`STATUS.md`](STATUS.md)** — update the ticket index table if
tickets were created or closed. This file is a read-only snapshot;
do not add inline status tracking (use Redmine).
2. **Update [`docs/docmap.md`](docs/docmap.md)** — if a doc was added,
removed, or substantively changed, update the table and "Last Reviewed"
date.
@@ -104,5 +127,6 @@ vendor/ Vendored KNELShellFramework
Solo-founder R&D Proxmox cluster in a private residence. Shoestring budget.
Production lives on a Cloudron VPS in Reston VA. See
[`STATUS.md`](STATUS.md) for current state and
[`proxmox/docs/PROJECT.md`](proxmox/docs/PROJECT.md) for the fleet report.
[`STATUS.md`](STATUS.md) for the ticket index and infrastructure summary.
All work is tracked in [Redmine](https://projects.knownelement.com)
(version: Potential to Kinetic Ready, due 2026-09-30).