Skip to content

Refresh STATE + ROADMAP + concept §3.5 to reflect plugin landscape#2

Merged
lx-0 merged 2 commits into
mainfrom
claude/post-merge-state-refresh
Apr 25, 2026
Merged

Refresh STATE + ROADMAP + concept §3.5 to reflect plugin landscape#2
lx-0 merged 2 commits into
mainfrom
claude/post-merge-state-refresh

Conversation

@lx-0

@lx-0 lx-0 commented Apr 25, 2026

Copy link
Copy Markdown
Member

Summary

Three loose ends from PR #1 -- which intentionally deferred concept.md and left STATE/ROADMAP for a follow-up.

What's in this PR

.ytstack/STATE.md:

  • Append "Session 2026-04-25 (afternoon)" block covering the plugin-landscape session: 5-plugin family locked, 3 new DECISIONS entries (already merged via PR Lock plugin landscape architecture; ystacks as primary install path #1), Yesterday-AI/ystacks + Yesterday-AI/yastack repos shipped (both with own minimal .ytstack/ for dogfooding), Levels-of-AGI 3-4 framing fix, M010 + M011 surfaced as next substantive work
  • Refresh next-action queue with concrete commands inline (no chat-verweise)
  • last_updated bumped + current_milestone annotated

.ytstack/ROADMAP.md:

  • Add M010 (Workflow Reorder + Brownfield-Without-.ytstack) and M011 (Post-Summarize Lifecycle) as planned milestones with goal + exit criteria + scope-reference to relevant DECISIONS entries
  • M010 has two-part scope: finish the original 2026-04-24 greenfield-flow reorder AND add the new "user runs ytstack inside an existing repo with no .ytstack/ yet" case as a third workflow
  • M011 wraps vendor/gstack/ship/SKILL.md plus one post-ship skill (canary OR document-release, choice deferred to milestone planning); other ship-family skills are explicitly out of scope per DECISIONS 2026-04-25 lifecycle-heuristic
  • Frontmatter total_milestones bumped 9 -> 11

docs/concept.md §3.5:

  • Rewritten to reflect ystacks consolidation. Was deferred per PR Lock plugin landscape architecture; ystacks as primary install path #1's marketplace DECISIONS entry "How to apply" line ("docs/concept.md §3.5 update is deferred to a separate change so this DECISIONS entry lands first as the source-of-truth")
  • Now describes: monorepo + catalog hybrid; 5-plugin family with locations + visibility; service-repo plugin pattern; ytstack's legacy self-marketplace status
  • Concept paper is now consistent with DECISIONS 2026-04-25

Why

PR #1 landed the architectural decisions but intentionally left state-tracking and concept-paper consistency for a follow-up. This PR closes those loose ends so future sessions read a coherent state across DECISIONS / STATE / ROADMAP / concept.md.

Reviewer notes

  • No code changes -- documentation + state-tracking only.
  • M010 and M011 are entered as planned, not in-progress. Actual milestone planning happens via ytstack:plan-milestone when the user starts each.
  • ystacks + yastack repos are not in this repo's scope -- they live in their own repos and have their own .ytstack/ dogfood scaffolds (committed in their respective repos this session).

Test plan

  • Read STATE.md "Session 2026-04-25 (afternoon)" block and confirm it accurately summarizes the architecture session
  • Read ROADMAP.md M010 + M011 entries; confirm goals + exit criteria + scope-references are coherent with the DECISIONS they cite
  • Read concept.md §3.5; confirm it now matches DECISIONS 2026-04-25 "Marketplace consolidates on Yesterday-AI/ystacks (monorepo + catalog hybrid)"
  • Confirm no em-dashes ($'\xe2\x80\x94') were introduced
  • Confirm no chat-verweise in STATE.md (no "see chat" / "provided in chat" phrasing)

🤖 Generated with Claude Code

lx-0 added 2 commits April 25, 2026 15:57
…landscape

Three loose ends from PR #1 (which intentionally deferred concept.md and
left STATE/ROADMAP for a follow-up):

- .ytstack/STATE.md: append 'Session 2026-04-25 (afternoon)' block covering
  the plugin-landscape session (5-plugin family, 3 new DECISIONS, ystacks +
  yastack repos shipped, dogfood .ytstack/ in both, Levels-of-AGI 3-4 framing
  fix, M010+M011 surfaced). Refresh next-action queue with concrete commands
  + suggested topics inline (no chat-verweise).
- .ytstack/ROADMAP.md: add M010 (Workflow Reorder + Brownfield-Without-.ytstack)
  and M011 (Post-Summarize Lifecycle) as planned milestones with goal +
  exit criteria + scope-reference to the relevant DECISIONS entries.
  Frontmatter total_milestones bumped 9 -> 11.
- docs/concept.md §3.5: rewrite to reflect ystacks consolidation (was deferred
  per the PR #1 marketplace DECISIONS entry's 'How to apply' line). Now
  describes the monorepo + catalog hybrid, the 5-plugin family with locations
  + visibility, service-repo plugin pattern, and ytstack's legacy self-
  marketplace status. Concept paper now consistent with DECISIONS.
Per re-read of the dev.to + medium comparison articles cited in
docs/concept.md, gstack is the only framework with a complete release
pipeline (ship/land-and-deploy/canary/document-release/qa); superpowers
covers pre-merge closure (verification-before-completion +
finishing-a-development-branch + requesting-/receiving-code-review);
GSD has no shipping equivalent.

M011 chooses Option B: a balanced cherry-pick that uses gstack for
ship-mechanics and superpowers for PR-review discipline. Five skills
total in normal-flow order:

  summarize-task ->
    finishing-a-development-branch (superpowers) ->
    requesting-code-review (superpowers) ->
    receiving-code-review (superpowers, loops with above) ->
    ship (gstack) ->
    document-release (gstack)

Out of scope (deferred to a future milestone): land-and-deploy, canary,
setup-deploy (deployment + monitoring -- different skill-class), qa
(overlaps existing TDD).

Files updated:
- .ytstack/DECISIONS.md: new entry 'M011 scope -- 5-skill cherry-pick'
- .ytstack/ROADMAP.md: M011 entry expanded with skill table + scope refs
- .ytstack/STATE.md: M011 description in afternoon-session block updated
- docs/concept.md §3.6: requesting-/receiving-code-review pulled out of
  v0.2-deferred list into M011 active scope
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