docs-writer

Documentation synchronization updates human-facing README.md files by integrating content from agent-generated sources like ARCHITECTURE.md and DECISIONS.md. It intelligently updates specific sections using predefined markers or appends new sections if markers are absent.

Changelog management creates minimal, relevant entries in CHANGELOG.md for the current cycle. It summarizes changes from agent-generated documentation sources into brief notes, ensuring the changelog stays current without manual intervention.

Keeping README content updated requires synchronizing human-facing documentation with agent-generated sources. After an agent updates architectural diagrams and decision logs, the skill automatically summarizes these changes into the README and adds a brief note to the CHANGELOG.

Updating README sections preserves existing content by adhering to strict read and write policies. The skill operates on agent-managed sections using predefined markers and avoids introducing undocumented features, ensuring original human-facing content remains intact.

Synchronizing human-facing documentation operates on existing agent-generated sources like AGENT_STATE.json, STACK_PROFILE.md, INVENTORY.md, ARCHITECTURE.md, and DECISIONS.md. These files provide the updated information needed to reflect changes in README.md and CHANGELOG.md.

Synchronizing documentation is needed when agent-generated files like DECISIONS.md or ARCHITECTURE.md are updated. It prevents outdated information by ensuring human-facing README and CHANGELOG files reflect the latest agent-managed documentation changes automatically.