feat(course): build out all 27 modules, capstone, scaffold, and conventions

Scaffold the course repo and author the full curriculum in dependency-chain
order, following the settled build decisions in handoff.md.

- Scaffold: course README, vendor-neutral AGENTS.md (dogfoods Module 5),
  _TEMPLATE.md (the fixed 9-section module shape), root .gitignore, ship config.
- Modules 1-2: reference exemplars (locked for tone/depth/lab style).
- Modules 3-27: full lessons + runnable labs, each following the template,
  respecting the chain, vendor/model-agnostic, with "feel the pain" labs.
- Module 8 hosting comparison web-researched and date-stamped (as of 2026-06-22),
  not written from memory; expansion-zone modules carry Verify-before-publish.
- Capstone: the full loop end to end on the running tasks-app example.

Lab code syntax-checked (Python/shell/YAML); every module has the 7 core
template sections.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT

modules/24-assistive-agents/lab/triage.py

@@ -0,0 +1,110 @@
+"""Assistive issue-triage agent — local simulation of a triage bot.
+
+Stands in for a forge-native triage agent (triggered when an issue opens) without a hosted account.
+It assembles the prompt, then validates and renders the AI's suggestion — and stops at a human
+confirm. The agent proposes labels and a route; it does not apply them.
+
+    python triage.py prompt                          # taxonomy + issue -> prompt. Paste to your AI.
+    python triage.py apply ai-triage.sample.json     # validate + render + confirm gate
+
+The validation step matters: the agent may only use labels that exist in label-taxonomy.md. A
+hallucinated label is rejected. Stdlib only — no pip install.
+"""
+
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+HERE = Path(__file__).parent
+
+PROMPT_HEADER = """\
+You are an assistive issue-triage agent. Using ONLY the taxonomy below, propose labels, a route,
+and a rationale for the issue that follows. Return ONLY the JSON object the taxonomy specifies.
+
+================ LABEL TAXONOMY ===============
+{taxonomy}
+
+================ INCOMING ISSUE ===============
+{issue}
+"""
+
+# Allowed labels are the backticked `prefix:value` tokens in the taxonomy file. Keeping the source
+# of truth in the committed markdown — not hardcoded here — is the point.
+LABEL_RE = re.compile(r"`([a-z]+:[a-z0-9-]+)`")
+
+
+def allowed_labels(taxonomy_text: str) -> set[str]:
+    return set(LABEL_RE.findall(taxonomy_text))
+
+
+def cmd_prompt(args: argparse.Namespace) -> int:
+    taxonomy = Path(args.taxonomy).read_text()
+    issue = Path(args.issue).read_text()
+    print(PROMPT_HEADER.format(taxonomy=taxonomy, issue=issue))
+    return 0
+
+
+def cmd_apply(args: argparse.Namespace) -> int:
+    allowed = allowed_labels(Path(args.taxonomy).read_text())
+    try:
+        sug = json.loads(Path(args.response).read_text())
+    except (json.JSONDecodeError, FileNotFoundError) as exc:
+        print(f"error: could not read a JSON suggestion from {args.response}: {exc}")
+        return 1
+
+    labels = sug.get("labels", [])
+    bogus = [l for l in labels if l not in allowed]
+    if bogus:
+        print("=" * 70)
+        print("REJECTED — the agent suggested labels that aren't in the taxonomy:")
+        for l in bogus:
+            print(f"  - {l}")
+        print(
+            "\nThis is the guardrail working. The agent can only use labels you've committed to\n"
+            "label-taxonomy.md. Fix the prompt or the taxonomy and re-run; do not apply this.\n"
+        )
+        return 1
+
+    print("=" * 70)
+    print("TRIAGE AGENT — suggestion (advisory only)")
+    print("=" * 70)
+    print(f"\n  Labels:        {', '.join(labels) or '(none)'}")
+    print(f"  Route to:      {sug.get('assignee_type', '?')}")
+    print(f"  Confidence:    {sug.get('confidence', '?')}")
+    print(f"  Rationale:     {sug.get('rationale', '')}\n")
+
+    print("-" * 70)
+    print(
+        "Human confirm gate. The agent did NOT apply these labels or assign anyone.\n"
+        "You decide:\n"
+        "  - confirm   apply the labels and route as proposed\n"
+        "  - edit      change a label or the route, then apply\n"
+        "  - reject    the triage is wrong; do it yourself\n"
+        "\nA wrong label here costs one glance and one click to fix — which is exactly why\n"
+        "triage is the safe place to let an agent in first.\n"
+    )
+    return 0
+
+
+def main(argv: list[str]) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    p = sub.add_parser("prompt", help="assemble the triage prompt to paste to your AI")
+    p.add_argument("--taxonomy", default=str(HERE / "label-taxonomy.md"))
+    p.add_argument("--issue", default=str(HERE / "sample-issue.md"))
+    p.set_defaults(func=cmd_prompt)
+
+    a = sub.add_parser("apply", help="validate + render the AI's suggestion, then gate it")
+    a.add_argument("response", help="path to the JSON the AI returned")
+    a.add_argument("--taxonomy", default=str(HERE / "label-taxonomy.md"))
+    a.set_defaults(func=cmd_apply)
+
+    args = parser.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv[1:]))