[codex] feat(ai-sdlc-init): introduce v3 scaffold in r3dlex/orchestra - #12
Merged
Conversation
added 5 commits
June 7, 2026 21:32
Apply the canonical v3 AI-SDLC scaffold. Topology: standalone, sync=physical-copy. Closes: #11
…ration.json The v3 scaffold helper used a single-quoted heredoc for the human-override files, which left literal `'$REPO_NAME'` in the committed content. Re-emit those files with the actual repo name interpolated. Also add: - docs/architecture/data-contracts/ directory (required by documentation-blueprint) - .ai/drift/last-generation.json (required by generation rule 4 of documentation-blueprint.md) Follow-up to feat(ai-sdlc-init): introduce v3 scaffold in r3dlex/orchestra. Found by code-review lane of the v3 rollout PR review loop.
…ze empty docs subdirs After the v3 rollout PR merges, the feature branch `codex/ai-sdlc-init-v3-rollout` is deleted. `.ai/matrix.json:upstream_authority.ref` was pointing to that branch, which would have made every downstream drift report reference a dead ref. Update the ref to `main` so it remains valid post-merge. Also add `.gitkeep` to `docs/specifications/ACTIVE/`, `docs/specifications/ARCHIVED/`, and `docs/learning/concept-maps/` so the v3 structural check #1 (validation.md) sees these directories explicitly. Git does not track empty directories, so the validator's directory-presence check was passing locally but failing in the rolled-out repo. Follow-up to feat(ai-sdlc-init): introduce v3 scaffold in r3dlex/orchestra. Found by code-review recheck after the v3 rollout PR review loop.
…oting Replace the repo-name-substituted content with the canonical v3 fixture prose from r3dlex/skills/ai-sdlc-init/reference/fixtures/v3/standalone/. The canonical prose avoids any shell-variable interpolation in the human-override files, matching the source-of-truth fixture exactly. The repo name remains available via `.ai/matrix.json:upstream_authority` for any drift report or agent that needs it; the human-override files are intentionally generic. Follow-up to feat(ai-sdlc-init): introduce v3 scaffold in r3dlex/orchestra.
…port
Two LOW-severity items from the v3 rollout PR review loop:
1. System prompts `.ai/system-prompts/{architect,developer,qa-engineer}.md`
were byte-identical. Add role-specific sentences so the prompts actually
guide each role (architect owns ADRs/matrix.json classification;
developer owns the scaffold script and per-repo application;
QA owns validation, fixture set, and regression suite).
2. `.ai/matrix.json:sync_status` was missing the `last_drift_report`
field present in the canonical v3 standalone fixture. Add it pointing
to `.ai/drift/last-drift.json`, and emit the last-drift.json stub
(no-drift baseline) to match.
Follow-up to feat(ai-sdlc-init): introduce v3 scaffold in r3dlex/orchestra.
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
1 participant
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.
Applies the canonical v3 AI-SDLC scaffold to r3dlex/orchestra. Closes #11. Topology: standalone, sync=physical-copy. Modules at r3dlex/skills/ai-sdlc-init/modules/.