MAPS: Agentic And Multi-Agent Pipeline Skills

MAPS is a public skill-based framework for building agentic and multi-agent systems.

This repository is the public MAPS skill package. It contains the agentic skill set and multi-agent skill set only. Mindshare/Mojo organization files, private automations, channels, role memories, runtime state, and internal operating records belong outside this public package.

It turns the agent development lifecycle into reusable phase skills:

phase alignment -> foundation -> shape -> define -> design -> equip -> build -> evaluate -> deploy -> observe -> improve

Each phase has two artifacts:

• A phase guide in phases/ for planning, documentation, and shared vocabulary.
• A reusable Agent Skill in skills/ for agent-compatible tools that support SKILL.md.

Phase Map

Phase	Core question	Primary output
Align	What lifecycle, structure, naming, scope, and scaffolding are we agreeing to use?	Phase alignment brief
Define	What job should this agent or system do, for whom, and within what boundaries?	Agent brief
Design	How should the agent or agents reason, coordinate, escalate, and stay aligned?	System design
Build	How do we implement the agent loop, prompts, state, and orchestration?	Working agent
Equip	What tools, data, permissions, memory, and integrations does the agent need?	Capability map
Evaluate	How do we prove the agent works, fails safely, and improves over baselines?	Eval suite
Deploy	How do we release it into a real environment with appropriate controls?	Release plan
Observe	How do we monitor behavior, cost, quality, drift, failures, and outcomes?	Observation plan
Improve	How do we turn production evidence into better prompts, tools, evals, and workflows?	Improvement backlog

Repository Layout

maps/
  phases/       Phase guides for each MAPS phase
  skills/       One Agent Skill per phase
  templates/    Reusable phase deliverable templates
  catalogs/     Curated repos, skills, tools, and references
  docs/         Framework notes and contribution guidance

Using The Skills

Install or copy the folders under skills/ into an Agent Skills-compatible directory, such as ~/.codex/skills/, .agents/skills/, or another client-specific skills path.

Each skill is intentionally small. The phase detail lives in phases/ and the reusable deliverable shells live in templates/.

Skill Operating Contract

MAPS keeps skill behavior consistent across sessions with three layers:

• Always-on instructions in AGENTS.md and global Codex instructions for one-question interviews, memory helper usage, completion reports, skill versioning, and validation before publish.
• Per-skill contracts inside every SKILL.md, including Versioning, Changelog, Output, Completion report, project-foundation lookup, one-question interviews, and memory-helper instructions.
• A repo validator at scripts/validate_maps_skills.py that checks every MAPS skill for the required operating contract.
• Source catalogs in catalogs/global-installs.md and catalogs/skill-rules.md that define global installs, skill rules, and their implementation locations for the MAPS program/plugin.

Run the validator before publishing skill changes:

python scripts/validate_maps_skills.py

Public Skill Sets

Agentic pipeline skills:

• phase-alignment
• foundation
• shape
• define-agent
• design-agent
• design-experience
• design-experience-plus-plus
• equip-agent
• build-agent
• build-agent-plus-plus
• evaluate-agent
• evaluate-agent-plus-plus
• deploy-agent
• deploy-agent-plus-plus
• observe-agent
• observe-agent-fuse
• observe-agent-phoenix
• observe-agent-smith
• improve-agent

Multi-agent pipeline skills:

• multi-agent-roster
• multi-agent-contracts
• multi-agent-coordination
• multi-agent-buildout
• multi-agent-capabilities
• multi-agent-orchestration
• multi-agent-evaluate
• multi-agent-deploy-observe
• multi-agent-improve

Not public package scope: organization scaffolding, role hiring/onboarding, private automations, channels, handoff queues, role memories, runtime state, secrets, and internal release-control files.

Project Site

Open docs/phase0.html to view the static project page for MAPS scaffolding and Phase 00 structure.

MindShare Central

MindShare Central lives in local-client/. To run it locally or build the Windows installer, see local-client/README.md.

Curation Model

MAPS catalogs repos and skills by phase. A good catalog entry should explain:

• Why it belongs in the phase.
• Whether it is recommended, useful reference, experimental, or avoid.
• Fit, maintenance, adoption, license, security, docs, and builder value.

Start with catalogs/repos.md and catalogs/skills.md.

Global Installs And Rule Catalogs

MAPS distinguishes project-local skills from global installs:

• catalogs/global-installs.md defines global repos, plugins, hooks, vaults, context packets, and helper layers available to the MAPS program/plugin.
• catalogs/skill-rules.md defines the MAPS skill operating rules and where each rule is implemented.
• Website pages may explain these contracts, but the source catalogs are the durable plugin/program definitions.