docs(unic-archon-dlc): reconcile Archon version + node schema (redesign step 00)#260
Open
orioltf wants to merge 1 commit into
Open
docs(unic-archon-dlc): reconcile Archon version + node schema (redesign step 00)#260orioltf wants to merge 1 commit into
orioltf wants to merge 1 commit into
Conversation
…gn step 00)
Pre-work step 00 gates the workflow redesign. Establishes the truth the
refactor must build on:
- Installed Archon is v0.3.12 (brew formula caps there; 0.4.1 is GitHub-only
and not brew-installable). The "Archon >= 0.10" claim was fictional.
- The CLI uses a key-discriminated node schema (one of command|prompt|bash|
script|loop|approval|cancel), NOT the type:-style schema the 7 shipped
workflows use. `archon validate` passes them anyway because the stray
`type:` field is ignored — masking silent failures: HITL gates never pause,
loops run once, fresh_context is ignored, {{ inputs.slug }} never substitutes.
Why this matters: it's a blocking migration, not a cosmetic mismatch — every
gate, loop, and slug reference is inert while validation reports success.
Deliverables (research + writing only; no workflow YAML touched):
- Add ADR-0011: version target (>=0.3.12) + node-schema conventions + the
HITL/loop/fresh-context/data-flow answers all redesign steps depend on.
- PLAN.md pre-work #1 rewritten with the confirmed version, translation table,
silent-failure finding, and blocking-migration flag.
- Correct ">= 0.10" -> ">= 0.3.12" in AGENTS.md (CLAUDE.md symlink).
- Fix ADR-0003 status: Accepted -> Superseded by ADR-0009 (Ralph-era spec
format retired by 0009 but never reflagged); update ADR index + add 0011 row.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Pre-work step 00 of the
unic-archon-dlcworkflow redesign (docs/redesign/PLAN.md). This step gates every other step — the redesign assumed it could refactor the 7 shipped workflows in place, but that assumption rested on a version and a schema that turned out to be wrong. We must lock the truth before touching workflow YAML.What was found (empirically)
brew … coleam00/archon/archon→0.3.12 already installed); the "update → v0.4.1" notice is GitHub-Releases-only, not brew-installable. TheAGENTS.mdclaim "Archon ≥ 0.10" was fictional — no such version line exists.command|prompt|bash|script|loop|approval|cancel); the shipped YAMLs use atype:discriminator + node-levelfresh_context:+inputs:/{{ }}Jinja.archon validatepasses all 7 anyway — because the straytype:field is silently ignored and every node still carries a recognised content key. Validation success masks silent semantic failures:type:-style)type: interactive+fresh_context+prompt:type: loop+prompt:(noloop:/until:)fresh_context: trueinputs:+{{ inputs.slug }}This is a blocking migration, not a cosmetic mismatch — gates, loops, fresh-context, and slug substitution are all inert while the CLI reports success.
Changes (research + writing only — no workflow YAML touched)
PLAN.mdpre-work Fix release workflow, document Gitflow, and close post-launch open points #1 rewritten — confirmed version, translation table, silent-failure finding, ⚠ blocking-migration flag,$ARGUMENTS-slug implication.AGENTS.md(+CLAUDE.mdsymlink) —≥ 0.10→≥ 0.3.12+ ADR-0011 link.Accepted→Superseded by ADR-0009(Ralph-era spec format retired by 0009 but never reflagged) + ADR index updated + 0011 row added."Done when" — answered
approval:node + workflow-levelinteractive: trueloop:key (prompt/until/max_iterations)context: fresh(orloop.fresh_context)$nodeId.output(.field); input via$ARGUMENTS;$ARTIFACTS_DIR; noinputs:/{{ }}Verification
archon validate→ ok (no YAML touched).lib/changes → no typecheck/test.🤖 Generated with Claude Code