agent-subagent-guidelines

Defines rules for assigning implementation work to AI subagents within approved plans.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/hyvanmielenpelit/SharedAgentSkills --skill agent-subagent-guidelines-hyvanmielenpelit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-subagent-guidelines
Source: https://github.com/hyvanmielenpelit/SharedAgentSkills/tree/main/skills/agent-subagent-guidelines
Command: npx skills add https://github.com/hyvanmielenpelit/SharedAgentSkills --skill agent-subagent-guidelines-hyvanmielenpelit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI subagents on a shared codebase causes parallel build collisions, conflicting file edits, and premature commits. This Skill establishes strict orchestration rules so subagents write code safely while the orchestrator owns builds, tests, and commits. ## Core Features & Use Cases - Mandatory Subagent Use plan section: Every implementation plan must declare subagent assignments with tier, files, and rationale, plus any human tasks requiring approval. - Role-based model tiers: Classifies work as deep, standard, mechanical, or inherit, resolved to actual models at spawn time rather than a stale written roster. - Strict safety rules: Enforces file-level exclusivity, prohibits subagents from building, testing, linting, or committing, and protects uncommitted changes from being overwritten. - Use Case: When writing an implementation plan that spans 8 files across 3 components, use this Skill to decompose the work into non-overlapping subagent assignments, pick the right tier per task, and sequence build steps at regeneration boundaries. ## Quick Start Ask the agent to read the subagent guidelines and write the Subagent Use section for your implementation plan before spawning any subagents.

Frequently Asked Questions about agent-subagent-guidelines

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

FAQPage Schema
How do I assign work to AI subagents in an implementation plan?

Every plan must include a Subagent Use section listing each task with its tier, files, and rationale. Assign non-overlapping file sets to parallel subagents and sequence any tasks that touch the same file.

What are the deep, standard, and mechanical model tiers?

Tiers are roles named by the property the work needs: deep for ambiguous cross-layer reasoning, standard for well-specified plan steps, and mechanical for identical pre-specified edits. The orchestrator resolves tiers to actual installed models at spawn time.

Can a subagent run builds or tests to check its own work?

No. Subagents never run builds, tests, linters, generators, or migrations because parallel toolchains collide and a subagent cannot know the round's state. The orchestrator runs all verification after every subagent has returned.

Can subagents commit changes to git?

No. Subagents never run git commit or git push in any repository. The orchestrator owns the round and makes a single commit after all subagents have returned and verification passes.

When should a task be assigned to a human instead of a subagent?

Assign to the human only for very large relocation operations, typically moving 50 or more lines across files where agent retries would cost more than the handoff. The plan must ask the user to approve each human assignment, and the orchestrator handles it if declined.

What happens if a subagent might overwrite uncommitted changes?

The subagent reports the risk to the orchestrator, which asks the user to commit first or explicitly approve proceeding. No agent may overwrite uncommitted changes without explicit user permission.