Feature-porting process docs (from the project-profiles port session) - #493
Merged
Conversation
Two-phase contract distilled from the project-profiles port (PR #492): Phase 1 (interactive scoping — research fan-out, divergence table, decisions locked with the user, plan doc) and Phase 2 (autonomous implementation — red-first TDD per phase, commit-and-continue at clean boundaries, cross-cutting audit list, E2E through the real binary, ship to a feature-port-labeled PR without merging). Companion append-only file feature-porting-lessons.md holds the pitfalls-and-lessons list (12 entries seeded from this session); Phase 2 agents append to it in their PRs and the review process reviews its diff on every feature-port PR. Also ticks off the final plan items in the project-profiles plan. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
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
2 participants
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.
Summary
The second deliverable of the bd-fu16z22k session (PR #492): the feature-porting process, written up as a reusable contract.
claude-notes/instructions/feature-porting.md— the two-phase process: Phase 1 (interactive scoping: parallel Q1-impl/Q1-docs/Q2-architecture research, skein prior-art search, divergence table + strictness list + architecture proposal, decisions locked with the user, executable plan doc) and Phase 2 (autonomous implementation: red-first TDD per plan phase, one-phase-per-commit at clean gates, cross-cutting audit list, mandatory E2E through the real binary, and shipping to afeature-port-labeled PR — push/PR permitted, merging reserved for the separate review process).claude-notes/instructions/feature-porting-lessons.md— append-only pitfalls-and-lessons companion, seeded with 12 entries from the profiles port. Phase 2 agents append entries in their PRs; the review process reviews this file's diff on everyfeature-portPR.claude-notes/plans/2026-08-10-project-profiles-port.md(PR Project profiles: port from Quarto 1 (bd-fu16z22k) #492 merged, strand closed).🤖 Generated with Claude Code