docs: define plan 09 and 11 briefs

This commit is contained in:
Amruth Pillai
2026-09-05 23:19:22 +02:00
parent 8f7faca67d
commit 01f4963762
2 changed files with 62 additions and 0 deletions
@@ -0,0 +1,33 @@
# Implement plan 09: user-controlled Git backup documentation
Read entire approved plan first:
`/Users/amruth/orca/workspaces/reactive-resume/planning-pr-3455/plans/09-external-version-backup.md`. Also read current
worktree `AGENTS.md`, referenced domain/issue instructions, relevant ADRs, `/Users/amruth/.codex/RTK.md`, and
`/Users/amruth/.agents/skills/documentation-writer/SKILL.md`. Plan supplies document type, audience, goal, scope, and approved
structure; do not pause for routine outline approval. Portable fallback: fetch PR #3455 and use
`git show a2557b2ad40e06e1e63eb655f286e6a78fe6bf0d:plans/09-external-version-backup.md`.
Do not spawn subagents. Do not touch coordinator ledger or another worktree. Do not merge, mutate issues, push, or create PR.
Required execution:
- Confirm clean worktree, fetch current `origin/main`, rename branch `codex/issue-2705-git-backup-docs`, run exact drift
command, fetch live #2705 body/comments/state/linked PRs, and run root intent discovery before edits.
- Revalidate current export shapes and history semantics from exact source/tests. Stop if exporter lacks required document
types or synthetic restore loses content; do not broaden into runtime fixes.
- Modify only `docs/guides/exporting-your-resume.mdx` and
`docs/guides/undoing-changes-and-version-history.mdx`.
- Document single-resume JSON, independent cover-letter JSON, and account archive differences; stable filenames; image URL
availability; private-data/repository-visibility warning; local-only Git workflow; non-destructive import-as-new recovery;
rolling in-app versions versus owner-managed Git. Include plan's exact local-only command sequence. No automatic sync,
credentials, remote URL, `git push`, whole-account restore promise, or new product UI.
- Use only synthetic data. Run API export/version tests specified by plan. Validate single-resume import round-trip using
existing synthetic fixtures/tests or a bounded disposable test; never use private data.
- Execute command sequence in `mktemp -d`, staging only `resume.json` and `cover-letter.json`; show changed visible field in
`git diff`. Do not modify global Git config if identity missing; record limitation.
- Run plan's focused `rg`, markdown lint, `git diff --check`, and two-file name-only gate. Self-review every acceptance item.
- Commit with normal message. Leave branch local for independent review.
Write report `.orchestration/plan-09-implementation.md`: verified facts vs uncertainty, live state, drift, exact commit/files,
commands/results, fixture details, skipped gates, risks, issue coverage, PR status (`not created`). Final response: status,
commit, one-line tests, report path, concerns; at most ten lines.
@@ -0,0 +1,29 @@
# Implement plan 11: JSearch removal and tailoring documentation
Read entire approved plan first:
`/Users/amruth/orca/workspaces/reactive-resume/planning-pr-3455/plans/11-job-search-policy.md`. Also read current worktree
`AGENTS.md`, referenced issue/domain instructions, relevant ADRs, `/Users/amruth/.codex/RTK.md`, and
`/Users/amruth/.agents/skills/documentation-writer/SKILL.md`. Plan supplies document type, audience, goal, scope, and approved
structure; do not pause for routine outline approval. Portable fallback: fetch PR #3455 and use
`git show a2557b2ad40e06e1e63eb655f286e6a78fe6bf0d:plans/11-job-search-policy.md`.
Do not spawn subagents. Do not touch coordinator ledger or another worktree. Do not merge, mutate issues, push, or create PR.
Required execution:
- Confirm clean worktree, fetch current `origin/main`, rename branch `codex/issue-3010-jsearch-docs`, run exact drift command,
fetch live #3010 body/comments/state/linked PRs, and run root intent discovery before edits.
- Verify release history, current job-search redirect, agent tools, provider/model capability policy, and attachment UI before
wording claims. Stop if release history contradicts removal attribution or documented UI steps do not exist.
- Modify only `docs/changelog/index.mdx`, `docs/guides/using-ai-agent.mdx`, and
`docs/guides/ai-agent-tools.mdx`.
- Add factual v5.1.0 migration note, current controlled tailoring workflow using plan's exact synthetic job description, review
and undo guidance, pasted/attached-content behavior, and live-search capability distinction. No unverified removal motive,
paid JSearch restoration, stale model list, provider credentials, or promise that chat is equivalent structured search.
- Run exact API tool/capability tests and plan's focused `rg`, markdown lint, `git diff --check`, and three-file name-only gate.
Record real-provider/browser workflow as optional unavailable validation when not run.
- Self-review every acceptance criterion. Commit with normal message. Leave branch local for independent review.
Write report `.orchestration/plan-11-implementation.md`: verified facts vs uncertainty, live state, drift, exact commit/files,
commands/results, skipped gates, risks, issue coverage, PR status (`not created`). Final response: status, commit, one-line
tests, report path, concerns; at most ten lines.