diff --git a/docs/execution/briefs/implement-plan-09.md b/docs/execution/briefs/implement-plan-09.md new file mode 100644 index 000000000..ad849b967 --- /dev/null +++ b/docs/execution/briefs/implement-plan-09.md @@ -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. diff --git a/docs/execution/briefs/implement-plan-11.md b/docs/execution/briefs/implement-plan-11.md new file mode 100644 index 000000000..b6ab90084 --- /dev/null +++ b/docs/execution/briefs/implement-plan-11.md @@ -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.