Skip to content

docs(roadmap): #347 goal-mode research (no native CC primitive) - #348

Merged
BaseInfinity merged 1 commit into
mainfrom
docs/roadmap-347-goal-mode-research
May 24, 2026
Merged

docs(roadmap): #347 goal-mode research (no native CC primitive)#348
BaseInfinity merged 1 commit into
mainfrom
docs/roadmap-347-goal-mode-research

Conversation

@BaseInfinity

Copy link
Copy Markdown
Owner

Summary

Records research findings for issue #347 (Claude equivalent for Codex goal-mode workflow) and defers implementation.

What changed

Verdict

NO native CC primitive for goal mode. Sessions are independent JSONL files; persistence is indirect via `CLAUDE.md`, auto memory, and hooks. The closest path is exactly the wizard's existing pattern (skill + SessionStart hook + project file), just unwrapped for goal-mode semantics.

Per-feature mapping (verified against CC docs 2026-05-23)

Primitive Goal-mode?
TaskCreate / Agent SDK tasks NO — per-session only
Subagents PARTIAL — per-invocation context only
Slash commands / skills PARTIAL — standing instruction for current session only
Hooks (SessionStart, UserPromptSubmit) YES — the enforcement layer
Plan mode NO — per-turn only
CLAUDE.md PARTIAL — context not enforced config
Native /goal NO — not on the published roadmap

Prove-It Gate decision

Absorb into existing `/sdlc` skill as a "Long-Running Goal Mode" section + `GOAL.md`/`HANDOFF.md` templates rather than building a new `/goal-start`/`/goal-handoff`/`/goal-stop` skill trio. Per #236 functional bloat principle: default to absorption; promote to dedicated skill only if absorbed form proves too easy to ignore.

Why deferred

Only one demand signal (issue author). Per #233 pattern, build when a second user requests OR when the maintainer's own work hits the goal-mode gap. The roadmap entry has the full 5-step implementation sequence for cold pickup.

Research artifact

`.reviews/347-goal-mode-research.md` (gitignored per `.reviews/` convention from #236, content summarized in roadmap entry).

Test plan

  • `bash tests/test-doc-consistency.sh` green (39/39)
  • No code touched — pure docs change
  • CI `validate` green

Records research findings on whether Claude Code has a primitive
equivalent to Codex's $gdlc goal mode for long-running goal-bound work.

Verdict: NO native primitive. Closest path is GOAL.md template +
SessionStart hook + UserPromptSubmit reassertion + extension to the
existing /sdlc skill (not a new skill trio, per Prove-It Gate
absorption principle).

Implementation deferred. Research artifact at
.reviews/347-goal-mode-research.md (gitignored, summarized in entry)
documents the 7 CC primitives checked and why each falls short, plus
the 5-step build sequence for when this is picked up.

Trigger to revisit: second user request, or maintainer hits the gap
in their own work.
@BaseInfinity
BaseInfinity merged commit 0860062 into main May 24, 2026
3 checks passed
@BaseInfinity
BaseInfinity deleted the docs/roadmap-347-goal-mode-research branch May 24, 2026 01:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant