workspace-navigation

What problem does it solve?

Provides clear, reproducible guidance for placing files, decisions, and research artifacts in a shared agent workspace so collaborators and agents can find and contribute without creating disorder or duplicated context.

Core Features & Use Cases

• Placement Decisions: Recommends the correct directory path and a YYYY-MM-DD_topic-name_author.md filename for new artifacts.
• Frontmatter & Templates: Specifies required frontmatter fields (title, author, date, status, tags, related) and points to template patterns for discussions, decisions, and specs.
• Navigation & Discovery: Explains reading and grep-first workflows to locate decisions, research, and related content quickly during multi-agent coordination.
• Collaboration Patterns: Prescribes threaded discussion, specification review, and seed-sharing patterns to avoid overwrite conflicts and ensure provenance.
• Maintenance & Quality Checks: Includes naming conventions, README update guidance, and a checklist to validate placement and metadata completeness.

Quick Start

Use the workspace-navigation skill to place the new proposal into the correct workspace subdirectory, generate the recommended filename and frontmatter, and update the README with a pointer to the new file.