instruction-docs-synclisted

# Instruction Docs Sync ## Purpose Keep project instruction files current after meaningful work without creating a second source of truth or leaking agent-only files into normal branches. This skill runs after Serena memory sync and before quality checks, commits, GitHub sync, and `fullrepo` publish. ## Required Files - `AGENTS.md`: concise root project-instruction file (cross-tool standard, see https://agents.md/). - `.claude/CLAUDE.md`: Claude Code-native deep project memory. Both files are agent-only in normal product repositories: keep them local, ignore them through `.git/info/exclude`, and publish them through `fullrepo`. ## Source Of Truth Use only verified facts from: - Current code, config, scripts, manifests, hooks, workflows, tests, and git diffs. - Relevant Serena memories after they are current for the latest code. - Commands that actually exist and checks that actually run. - Official Claude Code documentation when the file describes Claude Code behavior. Do not copy chat history, future plans, speculation, secrets, tokens, cookies, or local credentials. ## Workflow 1. Run `python3 ${CLAUDE_PLUGIN_ROOT}/scripts/instruction_docs_state.py --json`. 2. Inspect changed files and recent commits to decide whether durable project facts changed. 3. Update `AGENTS.md` as the concise root project-instruction file: - repository purpose and source-of-truth paths; - setup, validation, release, deploy, git, and `fullrepo` commands; - architecture map, plug