agents-map

Generate AGENTS.md and ARCHITECTURE.md from subproject planning documents.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/yogogml0035-cpu/Assets --skill agents-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-map
Source: https://github.com/yogogml0035-cpu/Assets/tree/main/xquant-learning-notes/.agents/skills/agents-map
Command: npx skills add https://github.com/yogogml0035-cpu/Assets --skill agents-map

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation and refresh of AGENTS.md and ARCHITECTURE.md documents, simplifying the navigation and understanding of complex monorepos and multi-app workspaces.

Core Features & Use Cases

  • Automated Documentation: Generates AGENTS.md and ARCHITECTURE.md based on .planning/codebase/ documents.
  • Monorepo Support: Works with monorepos, multi-app workspaces, and service split repositories.
  • Use Case: When managing a large codebase with multiple subprojects, this Skill helps create a comprehensive overview of the system architecture and agent mapping.

Quick Start

Run the agents-map skill with the command: agents-map create-agents-map --codebases front/.planning/codebase back/.planning/codebase

Frequently Asked Questions about agents-map

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

FAQPage Schema
How do I generate AGENTS.md and ARCHITECTURE.md for a monorepo?

To generate AGENTS.md and ARCHITECTURE.md for a monorepo, you can run a command that reads subproject .planning/codebase/ documents to create comprehensive system architecture and agent mapping files.

What is agent mapping for multi-app workspaces?

Agent mapping for multi-app workspaces is the process of generating a comprehensive overview document that defines how automated agents interact with and navigate across different subprojects within a shared repository.

Does automated architecture documentation require existing planning directories?

Yes, automated architecture documentation requires existing subproject planning directories. The Skill reads directly from the .planning/codebase/ folders within your monorepo to extract structural and architectural information.

How do I create an agents map for separate front and back end codebases?

To create an agents map for separate codebases, run the command specifying each path, such as: agents-map create-agents-map --codebases front/.planning/codebase back/.planning/codebase.

Do I need Python to automate system architecture documentation generation?

Yes, you need Python installed to automate system architecture documentation generation. The Skill relies on Python scripts to process the codebase planning directories and generate the final mapping documents.

Can I refresh existing AGENTS.md files in a service split repository?

Yes, you can refresh existing AGENTS.md files in a service split repository. The Skill automates both the initial generation and subsequent updates of these documents as your multi-app workspace evolves.