Skip to content

roadmap: portable AI-native SDLC - #148

Merged
yihanzhu merged 2 commits into
mainfrom
codex/playbook-roadmap
Aug 27, 2026
Merged

roadmap: portable AI-native SDLC#148
yihanzhu merged 2 commits into
mainfrom
codex/playbook-roadmap

Conversation

@yihanzhu

@yihanzhu yihanzhu commented Aug 27, 2026

Copy link
Copy Markdown
Owner

What changes

  • Makes the full AI-native SDLC the product north star.
  • Defines a portable core with harness, model, Git forge, CI, execution, publisher, and deployment adapters.
  • Treats Claude Code, Codex, GitHub, and the current CI setup as the default profile, not product requirements.
  • Defines ystack as the product, this repository as its first self-hosted target, and an unrelated external repository as the portability proof.
  • Records risk-based plan gates as accepted target policy. It also states plainly that the current manager does not enforce that policy yet.
  • Records the rollout order: contracts, controls, dry runs, alternate adapters, then bounded writes and the full lifecycle.
  • Keeps PR impl: v2-phase-2 (b — lane) #146 as a draft research record. It must not merge as the production lane.

Scope

This PR changes direction and policy documents only. It does not add or enable an autonomous workflow. It does not change the live /yshifu installation. The first implementation intent is deliberately kept out of this PR and will use the normal G1 artifact gate after this direction is accepted.

Review fixes

  • Makes the plan gate target policy instead of claiming the current manager already enforces it.
  • Keeps the constitution-path lists in AGENTS.md, REVIEW.md, and proposals/README.md identical.

Verification

Verified on 4cd48b4:

  • ShellCheck 0.11.0 over every tracked shell file: passed.
  • codex-degraded-gate: 91 passed, 0 failed.
  • models-conf-parser: 63 passed, 0 failed.
  • north-star-gate: 226 passed, 0 failed.
  • north-star-resolver: 74 passed, 0 failed.
  • v2-check-rename: 13 passed, 0 failed; pathname and probe guards also passed.
  • v2-pending-stage, v2-quota-preflight, and v2-round-cap: all cases passed.
  • Required-file structure check: structure ok.
  • Rename gate: clean.
  • North-star marker discipline: ok.
  • Final detached worktree matched the verified commit.

Closes #147

@yihanzhu

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f70aeac5a9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread AGENTS.md Outdated
Comment on lines +54 to +58
- **Risk sets the plan gate.** High-risk work — constitution paths, workflows,
identity/auth, security controls, migrations, deployment/production infrastructure,
or broad architecture — requires the operator to accept `plan.md` before code.
Routine work may keep plan + code in one PR only after an independent plan check
records acceptance before the write phase. The author cannot accept its own plan.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge [Compliance] Wire the plan gate before declaring it active

The current in-session path still tells yshifu to spawn a coder immediately after an issue gets ready (manager/CLAUDE.md:395-397 and templates/yshifu-command.md:23), with no risk check or accepted-plan step. As a result, the next high-risk issue can start implementation after only spec approval or manager consensus, even though this change makes operator acceptance of the exact plan a current safety rule. Update the live manager/template instructions or keep this rule explicitly future-only until that path enforces it.

AGENTS.md reference: AGENTS.md:L54-L58

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 4cd48b4. The risk-tier plan gate is now explicitly accepted target policy, not current behavior. AGENTS.md, README.md, and work/README.md all say the current manager does not enforce it yet, and this directions-only PR does not claim or wire a live gate.

Comment thread AGENTS.md
Comment on lines 96 to 98
the **constitution paths** — `.github/**`, `.claude/**`, `AGENTS.md` (this file),
`CLAUDE.md`, `REVIEW.md` — such changes land as patches under `proposals/` that the
`CLAUDE.md`, `REVIEW.md`, `ROADMAP.md` — such changes land as patches under `proposals/` that the
operator applies. That is the same list `REVIEW.md` uses; the two must always match, so

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge [Compliance] Add ROADMAP to the proposals path list

This adds ROADMAP.md to the constitution paths, but proposals/README.md:3-4 still defines that set without it. That leaves the guide for constitution patches out of sync with the new rule and can cause future work to omit the required proposal treatment for roadmap changes. Update that list alongside the two lists changed here.

AGENTS.md reference: AGENTS.md:L94-L100

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in 4cd48b4. proposals/README.md now includes ROADMAP.md, so its constitution-path list matches AGENTS.md and REVIEW.md.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploying ystack with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4cd48b4
Status: ✅  Deploy successful!
Preview URL: https://7cef934d.fabrica-6yx.pages.dev
Branch Preview URL: https://codex-playbook-roadmap.fabrica-6yx.pages.dev

View logs

@yihanzhu

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Another round soon, please!

Reviewed commit: 4cd48b44aa

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@yihanzhu
yihanzhu merged commit 7622da7 into main Aug 27, 2026
2 checks passed
@yihanzhu
yihanzhu deleted the codex/playbook-roadmap branch August 27, 2026 23:56
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.

Adopt the portable AI-native SDLC north star and roadmap

1 participant