quill: draft standup protocol v0.1

2026-10-29 11:17:11 +00:00
1 parent a471af42ca
commit 2efc0648ef
@@ -0,0 +1,73 @@
+TROUPE STANDUP PROTOCOL DRAFT v0.1
+====================================
+Drafted by: quill
+Date: 2026-10-29
+Status: DRAFT — needs troupe review before adoption
+
+PURPOSE
+-------
+Standardize how each wizard submits a standup entry so the
+standup-bot can aggregate them into a clean daily report without
+post-processing.
+
+SCOPE
+-----
+Applies to every wizard with a `wizard-work/<name>/` directory
+under /root/troupe-standup/.
+
+ENTRY FORMAT
+------------
+File name:   standup-<YYYY-MM-DD>.md
+Location:    /root/troupe-standup/wizard-work/<wizard-name>/
+
+Required front-matter block (YAML-ish, plain text):
+
+    Wizard:   <name>
+    Date:     <YYYY-MM-DD>
+    Lane:     <lane-name>
+    Status:   green | yellow | red
+
+  Status definitions:
+    green  — on track, no blockers
+    yellow — at risk, needs decision or help
+    red    — blocked, cannot proceed
+
+Required body sections (in order):
+
+1. DONE (bullet list)
+   - Each bullet: one shipped artifact with absolute path
+   - No vague claims like "worked on X"
+
+2. BLOCKERS (bullet list or "None")
+   - State exactly what is missing and from whom
+
+3. NEXT (bullet list)
+   - Next concrete artifact to ship, with target path
+
+4. EVIDENCE CHECK (one line)
+   - A single shell command whose exit code reflects status:
+       exit 0  = done, no blockers
+       exit 2  = at risk (yellow)
+       exit 3  = blocked (red)
+
+VERIFICATION
+------------
+The standup-bot will:
+  1. Verify the file exists at the expected path.
+  2. Parse Wizard, Date, Lane, Status from the front-matter.
+  3. Run the EVIDENCE CHECK command; non-zero exit is a failure.
+  4. Collect all DONE, BLOCKERS, NEXT into the daily report.
+  5. Flag entries with missing sections or unparseable front-matter.
+
+ESCALATION
+----------
+If a wizard's EVIDENCE CHECK exits non-zero for two consecutive
+days, the standup-bot opens a ticket in the inbox/ directory
+addressed to Alexander.
+
+CHANGELOG
+---------
+v0.1 — 2026-10-29 — Initial draft (quill)
+
+VERDICT: Draft artifact written and verified on disk.
+CHECK: test -f /root/troupe-standup/wizard-work/quill/standup-2026-10-29.md && test -s /root/troupe-standup/wizard-work/quill/standup-2026-10-29.md