Move planning docs under planning/, rename backlog, add a changelog - #40
Open
andreisavu wants to merge 3 commits into
Open
Move planning docs under planning/, rename backlog, add a changelog#40andreisavu wants to merge 3 commits into
andreisavu wants to merge 3 commits into
Conversation
Rename FOLLOW_WORK.md to planning/backlog.md and drop the AgentHarness vs. Agent entry, which the runtime never actually chose between on purpose. Add planning/decisions.md for calls a branch already made and planning/changelog.md for what shipped, so the three spans of forward-looking work — open, closed, released — each have one home outside docs/, which stays for design contracts only. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018aZeuMcM9oDrExXHF7dAVp
A row per merged PR read like a commit log, not a changelog: it named the mechanism, not what changed for somebody building on Ambion. Group entries by theme under Added/Changed/Fixed instead, and start with an Unreleased section since nothing has tagged a release yet. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018aZeuMcM9oDrExXHF7dAVp
Two trackers under planning/ for now: open work and what shipped. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018aZeuMcM9oDrExXHF7dAVp
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
FOLLOW_WORK.mdtoplanning/backlog.md, and drop the "WhetherAgent or AgentHarness is Ambion's foundation" entry, which the runtime
never actually chose between on purpose.
planning/changelog.md, grouped by release with anUnreleasedsection at the top. Entries are themes for somebody building on
Ambion (the five primitives, presence, the workspace, the assistant),
not one line per merged pull request — nothing has tagged a release
yet, so everything so far sits under
Unreleased.FOLLOW_WORK.mdpath:CLAUDE.md,docs/exchange.md,docs/workspace.md(includingdropping the now-dead pointer to the deleted AgentHarness question),
demos/README.md, and a code comment inpackages/ambion/src/session.ts.Test plan
pnpm formatpnpm check(build, typecheck, lint, 81 tests)🤖 Generated with Claude Code
https://claude.ai/code/session_018aZeuMcM9oDrExXHF7dAVp
Generated by Claude Code