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.