workspace-navigation

Generate directory paths and YYYY-MM-DD_topic-name_author.md filenames for workspace artifacts.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/DojoGenesis/gateway --skill workspace-navigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-navigation
Source: https://github.com/DojoGenesis/gateway/tree/main/plugins/agent-orchestration/skills/workspace-navigation
Command: npx skills add https://github.com/DojoGenesis/gateway --skill workspace-navigation

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about workspace-navigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize files in a shared agent workspace to avoid conflicts?

Use frontmatter metadata fields like title, author, date, status, and tags in shared workspace files. This metadata enables grep-first navigation workflows so agents can quickly locate decisions, research, and specifications during coordination.

What naming convention should I use for shared workspace artifacts?

Update the README with a pointer to the new file after placing a new proposal into the correct workspace subdirectory. This maintains an index for discovery and validates that placement and frontmatter metadata meet quality checks.

How does workspace navigation work for multi-agent workflows?

Workspace navigation for multi-agent workflows uses grep-first reading patterns and frontmatter tags to locate decisions and related content. Threaded discussion and specification review patterns prevent overwrite conflicts while ensuring provenance across agents.

What's the best way to place research drafts in a collaborative repository?

Place research drafts by generating a directory path, standardized filename, and frontmatter fields based on artifact content. This reproducible placement approach ensures collaborators can discover and contribute to specifications without disorder.