publish-docs

What problem does it solve?

Automates publishing of Augur-generated project architecture artifacts so teams do not have to manually copy atlas, stories, and journeys into the documentation site or hand-edit the home page navigation.

Core Features & Use Cases

• Content sync: Copies atlas.json, story files, journey files, and optional manifest artifacts from local Augur output into the docs repository structure.
• Navigation wiring: Reads and updates the docs site's index content to add or refresh a project LinkCard using the atlas purpose as the card description.
• Repository workflow: Clones the docs repo, stages changes, commits with a descriptive message, and pushes to the main branch so the live site picks up updates.
• Use Case: Publish a newly analyzed project's architecture to the canonical docs site and ensure the home page reflects the latest project purpose.

Quick Start

Use the publish-docs skill with the project name to copy its augur output into the docs repo and update the home page LinkCard.