Make automatic research Org-backed and implementation files-first #4

Open

nsaspy wants to merge 6 commits from feature/org-files-first-research-handoff into main

nsaspy commented

2026-09-04 22:29:45 +00:00

Owner

What changed

automatic work packets now name a required roam/research/<project>/*.org artifact
research passes are required to persist each pass through the repository research writer
implementation handoffs explicitly use files-first ordering: research Org files -> design -> repository
scripts/implement.py now requires one or more --research inputs
promotion rejects missing, non-Org, out-of-project, or invalid research inputs
active implementation copies record their bound research files
regression tests cover both the worker handoff contract and implementation research binding
AGENTS.md makes the file-backed research and files-first implementation rules authoritative

This intentionally fails closed when an implementation is started without persisted research.

## What changed - automatic work packets now name a required `roam/research/<project>/*.org` artifact - research passes are required to persist each pass through the repository research writer - implementation handoffs explicitly use files-first ordering: research Org files -> design -> repository - `scripts/implement.py` now requires one or more `--research` inputs - promotion rejects missing, non-Org, out-of-project, or invalid research inputs - active implementation copies record their bound research files - regression tests cover both the worker handoff contract and implementation research binding - `AGENTS.md` makes the file-backed research and files-first implementation rules authoritative This intentionally fails closed when an implementation is started without persisted research.

nsaspy added 6 commits

2026-09-04 22:29:45 +00:00

feat: require Org research artifacts in worker handoff 451fc2c8a9

feat: make implementation files-first on Org research 7b9d3e6d0f

test: lock Org research handoff contract 0b8d151b1f

test: enforce files-first implementation research inputs 3371d40542

docs: make research Org-backed and implementation files-first 6d15bf59ef

fix: read research before design content

validate / rage (pull_request) Successful in 9m43s

Details

validate / rage (push) Successful in 11m41s

Details

50f034f7b2

nsaspy commented

2026-09-04 22:29:58 +00:00

Author

Owner

No we should allow for markdown files for non emacs using people.
make it a configuration option

No we should allow for markdown files for non emacs using people. make it a configuration option

validate / rage (pull_request) Successful in 9m43s

Details

validate / rage (push) Successful in 11m41s

Details

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin feature/org-files-first-research-handoff:feature/org-files-first-research-handoff

git switch feature/org-files-first-research-handoff

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main

git merge --no-ff feature/org-files-first-research-handoff

git switch feature/org-files-first-research-handoff

git rebase main

git switch main

git merge --ff-only feature/org-files-first-research-handoff

git switch feature/org-files-first-research-handoff

git rebase main

git switch main

git merge --no-ff feature/org-files-first-research-handoff

git switch main

git merge --squash feature/org-files-first-research-handoff