Files
TSYSGroupAIOS/questions-v1.md
T
mrcharles 374288a105 feat: bootstrap meta — cross-project best-practices template
Extract patterns from 18 projects across two machines (12 local infra +
6 remote personal/business via ssh survey). Ship a reusable Gitea template
with AGENTS.md, 5 Crush PreToolUse hooks, git pre-commit/pre-push, a
generalized rules engine, shared bash library, Makefile, lifecycle scripts,
and gardening loop. Includes the canonical BASELINE-PROMPT.md (13 sections)
and PATTERNS.md (standardization scorecard).

The repo self-applies: it passes its own shellcheck (zero info-level),
make fast, and all check-rules.sh checks.

💘 Generated with Crush

Assisted-by: Crush via Crush <crush@charm.land>
2026-08-07 11:17:53 -05:00

3.2 KiB

questions-v1.md

Git-tracked question log. The agent writes; the human reviews/edits inline. Version up when a round of answers lands. Synthesize resolved Q&A to Discourse/Redmine. See BASELINE-PROMPT.md §9.

Open questions

Q1. Git remote for meta?

  • Context: meta is now a git repo (locally) but has no remote configured. The auto-commit+push policy (baseline §4) can't complete without one.
  • Options: (a) new Gitea repo under reachableceo; (b) nest under an existing repo; (c) keep local-only for now.
  • Question: Where should meta push?
  • Answer: (human)
  • Decision: (human/agent)
  • Synthesized to:

Q2. The bin/ wrapper gap (redmine-cli / discourse-cli)

  • Context: PFVCluster's operational.md and AGENTS.md reference ~/daytoday/redmine/bin/redmine and ~/daytoday/discourse/bin/discourse as the entrypoints. But ls ~/daytoday/{redmine,discourse}/ shows only .gitignore + AGENTS.md (+ MIGRATION-PLAN.md for discourse) — no bin/, no Dockerfile. The actual CLI source lives in ~/projects/KNEL-AIMiddleware/{redmine,discourse}-cli/.
  • Question: Are the bin/ wrappers something that should exist (and were lost / never committed), or is the documentation aspirational? Should the template reference these CLIs at all, or stay tool-agnostic?
  • Answer: (human)
  • Decision: (human/agent)
  • Synthesized to:

Q3. Should the template ship the Discourse pointer-header pattern?

  • Context: PFVCluster migrated 36 in-repo .md files to 10-line pointer stubs citing https://community.turnsys.com/t/<N>. The template currently has scripts/garden.sh that warns about oversized non-Discourse .md, but doesn't enforce the pointer-header format.
  • Options: (a) keep it advisory (garden.sh warn only); (b) add an opt-in check-rule that fails if a tracked .md lacks a Discourse URL (excluding AGENTS.md/STATUS.md/etc.); (c) leave it project-local — infra projects want it, personal/business projects don't.
  • Question: Which option, and is the assumption in (c) right?
  • Answer: (human)
  • Decision: (human/agent)
  • Synthesized to:

Q4. Sub-agent nudge hook — wanted?

  • Context: A sub-agent proposed a non-blocking Crush hook (hooks/nudge-subagent.sh) that emits a stderr reminder after the Nth sequential file read, nudging toward dispatching a sub-agent. Mirrors football's "never read 10+ files sequentially" rule.
  • Options: (a) add it (non-blocking, advisory); (b) leave sub-agent use as prose policy only.
  • Question: Worth adding, or too noisy?
  • Answer: (human)
  • Decision: (human/agent)
  • Synthesized to:

Q5. JOURNAL.md vs Discourse audit-log for infra projects

  • Context: The template ships docs/JOURNAL.md as the append-only decision log. But PFVCluster (the most mature infra project) has NO JOURNAL.md — it uses Discourse topic #298 as the audit log and Redmine for work tracking. PATTERNS.md §5 noted this divergence.
  • Question: Should the template keep JOURNAL.md as the default, with infra projects swapping it for the Discourse-audit-log pattern? Or drop JOURNAL.md entirely in favor of "Discourse is the SoR"?
  • Answer: (human)
  • Decision: (human/agent)
  • Synthesized to: