swarm-onboarding

Generates an executive onboarding briefing from Git state, MEMORY.md, task.md, and architectural plans.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/tkogut/agents-os-core --skill swarm-onboarding-tkogut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarm-onboarding
Source: https://github.com/tkogut/agents-os-core/tree/main/global_skills/swarm-onboarding
Command: npx skills add https://github.com/tkogut/agents-os-core --skill swarm-onboarding-tkogut

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When a new AI agent or a new session joins a multi-agent project, it lacks context about the repository state, past decisions, active sprint goals, and forbidden approaches. This Skill automates context synchronization so agents start work with an accurate, shared understanding instead of guessing. ## Core Features & Use Cases - Git State Inspection: Checks the current branch, uncommitted changes, recent commits, and active Git worktrees to assess repository readiness. - SSOT Memory Ingestion: Reads .agents/MEMORY.md, task.md, and .agents/plans/ to surface architecture decisions, sprint goals, and explicitly rejected approaches. - Executive Briefing Output: Produces a structured 5-section report covering repository state, persistent memory, current sprint, implementation plans, and governance rules. - Use Case: A Claude Code session starts on a project managed by AGENTS-OS. Running the onboarding script instantly reveals the branch is behind origin, summarizes the last five commits, lists the active sprint goal, and reminds the agent never to push directly to main. ## Quick Start Run the swarm-onboarding skill to scan the project and generate an executive briefing of the repository state, memory, and current sprint before starting any coding task.

Frequently Asked Questions about swarm-onboarding

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

FAQPage Schema
How do I onboard a new AI agent to an existing project?▼

Run the onboarding script with python3 global_skills/swarm-onboarding/scripts/onboard.py from the project root. It scans Git state, MEMORY.md, task.md, and plans, then prints a structured executive briefing the agent can use as context.

How to sync context between Claude Code and other AI coding agents?▼

Use a shared single source of truth like .agents/MEMORY.md and task.md, then run an onboarding scan that reads these files plus Git history. This gives any agent the same architectural decisions, sprint status, and rejected approaches.

Does the onboarding script work outside a Git repository?▼

Yes, it still runs but reports limited information. The script locates the project root by searching for .agents or .git directories, and Git-related sections simply show empty or missing values when no repository exists.

What files does the agent onboarding briefing read?▼

It reads .agents/MEMORY.md for persistent memory, task.md or .agents/task.md for the active sprint, and .agents/plans/ for architectural plans. It also checks tmp/worktrees/ for active Git worktrees and runs git status and git log.

Why does the onboarding briefing show no sprint information?▼

This happens when neither task.md nor .agents/task.md exists in the project root. Create a task.md file describing the current sprint goal, or check .agents/plans/ for implementation plans as a fallback context source.