agentleFS
GustavoGutierrezGustavoGutierrez/engineering-skills/skills/technical-planner/SKILL.md

technical-planner

Skill0 starsChanged 5 months agoMITView on GitHub

Plan technical execution for software systems by organizing phases, dependencies, sequencing, infrastructure foundations, MVP scope, coordination points, and incremental architecture delivery.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

27 rules. About 0 are common, 25 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈25

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill to plan the technical execution of a software system before implementation.

    line 22
  2. Distinctive:

    Use this skill when the user asks to:

    line 28
  3. Distinctive:

    Create a technical roadmap or implementation plan.

    line 30
  4. Distinctive:

    Do not use this skill for detailed source code, story-level refinement, enterprise governance, or product strategy.

    line 38
  5. Distinctive:

    Avoid false precision: Use relative sequencing and readiness criteria unless the user provides real dates, capacity, or estimates.

    line 47
  6. Very specific:

    Use neutral placeholders: If teams, technologies, environments, or providers are unknown, use generic terms such as platform team, domain …

    line 51
  7. Distinctive:

    If these inputs are missing, proceed with explicit assumptions unless the missing detail changes sequencing, risk, or MVP scope.

    line 67
  8. Distinctive:

    Place foundation work before dependent feature work.

    line 103
  9. Distinctive:

    Add transition phases for hardening, scale, operations, and migration.

    line 105
  10. Distinctive:

    Add risk, assumption, issue, and dependency tracking.

    line 112
  11. Distinctive:

    Use this format unless the user requests a narrower deliverable:

    line 117
  12. Distinctive:

    Do architecture decisions before irreversible implementation.

    line 188
  13. Distinctive:

    Do environment and deployment foundations before continuous delivery assumptions.

    line 189
  14. Distinctive:

    Do contract design before multi-team parallel implementation.

    line 190
  15. Distinctive:

    Do data ownership and migration planning before data-dependent features.

    line 191
  16. Distinctive:

    Do security and access design before exposing sensitive workflows.

    line 192
  17. Distinctive:

    Do observability before production readiness claims.

    line 193
  18. Distinctive:

    Do end-to-end thin-slice validation before broad feature expansion.

    line 194
  19. Distinctive:

    Do operational readiness before launch or handoff.

    line 195
  20. Distinctive:

    When multiple teams or components are involved:

    line 209
  21. Distinctive:

    Add integration checkpoints before final release.

    line 213
  22. Distinctive:

    Avoid assigning the same foundation to multiple owners unless ownership boundaries are explicit.

    line 215
  23. Distinctive:

    Before presenting the plan, verify:

    line 220
  24. Distinctive:

    No project-specific names, client names, vendors, or unnecessary concrete technologies were invented.

    line 230
  25. Distinctive:

    Use tables for phases, dependencies, workstreams, risks, and roadmap summaries.

    line 235
  26. Distinctive:

    Use short bullets for assumptions, MVP boundaries, and readiness checks.

    line 236
  27. Very specific:

    Prefer relative order such as Phase 0, Phase 1, and Phase 2 over dates unless dates are provided.

    line 237

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Technical Planner

Purpose

Use this skill to plan the technical execution of a software system before implementation. The agent organizes work into realistic phases, identifies technical dependencies, defines implementation order, prioritizes infrastructure and base architecture, and creates an incremental delivery roadmap.

This skill is domain-generic. It must work for any software system, platform, team topology, or delivery model without embedding project-specific assumptions.

When to Use

Use this skill when the user asks to:

  • Create a technical roadmap or implementation plan.
  • Plan an MVP from a technical perspective.
  • Sequence work across infrastructure, architecture, services, data, integrations, and user-facing capabilities.
  • Identify dependencies, blockers, risks, and coordination points.
  • Prioritize foundational architecture before feature delivery.
  • Coordinate multi-team or multi-component execution.
  • Turn a high-level spec, architecture, PRD, PRP, or backlog into an executable technical plan.

Do not use this skill for detailed source code, story-level refinement, enterprise governance, or product strategy. Keep the output at execution-planning level.

Core Operating Rules

  1. Plan execution, not code. Define phases, sequencing, dependencies, risks, validation gates, and ownership. Do not write source code.
  2. Foundations before features. Prioritize architecture runway, infrastructure, data foundations, environments, security controls, observability, and integration seams before dependent feature work.
  3. Sequence by dependency and learning value. Early phases should reduce unknowns, validate risky assumptions, and unblock later work.
  4. Define incremental value. Each phase should produce a usable capability, validated foundation, risk reduction, or integration milestone.
  5. Make dependencies explicit. Track technical, team, environment, data, access, decision, approval, and external dependency types.
  6. Avoid false precision. Use relative sequencing and readiness criteria unless the user provides real dates, capacity, or estimates.
  7. Protect MVP scope. Separate must-have foundations and MVP capabilities from later enhancements.
  8. Plan for coordination. Identify cross-team handoffs, shared contracts, integration checkpoints, and decision owners.
  9. Make verification part of every phase. Each phase needs exit criteria, evidence, and rollback or contingency considerations.
  10. Use neutral placeholders. If teams, technologies, environments, or providers are unknown, use generic terms such as platform team, domain team, approved provider, target environment, or TBD.

Planning Inputs

Gather or infer these inputs before planning:

  • Target outcome and MVP goal.
  • Current baseline or starting point.
  • Known constraints and non-goals.
  • Required capabilities and major workflows.
  • Architecture decisions already made.
  • Technical risks and unknowns.
  • Teams or owners involved.
  • Environments, data, integrations, and access dependencies.
  • Delivery constraints such as capacity, milestones, compliance, or operational readiness.

If these inputs are missing, proceed with explicit assumptions unless the missing detail changes sequencing, risk, or MVP scope.

Dependency Types

Classify dependencies with this taxonomy:

TypeMeaningPlanning Action
ArchitectureFoundational decisions, module boundaries, contracts, or platform direction.Resolve before dependent implementation begins.
InfrastructureEnvironments, runtime, deployment, networking, storage, identity, observability, or secrets.Place early in the roadmap as architecture runway.
DataData model, migration, ownership, quality, lifecycle, privacy, or availability.Schedule before features that read or write dependent data.
IntegrationExternal systems, APIs, events, queues, imports, exports, or adapters.Define contracts and test seams before end-to-end work.
Security and ComplianceAccess control, audit, policy, approvals, threat modeling, or regulatory constraints.Add early review and explicit exit criteria.
Team CoordinationCross-team handoffs, shared components, review ownership, or release alignment.Add coordination checkpoints and named owners.
Product or DesignScope decisions, user flows, UX states, or acceptance criteria.Mark as blocker or assumption depending on impact.
Operational ReadinessMonitoring, alerting, runbooks, support, migration, rollback, or incident response.Include before release or production transition.

Execution Workflow

Phase 1: Intake and Framing

  1. Identify the desired outcome, MVP boundary, stakeholders, known constraints, and non-goals.
  2. Establish baseline readiness and major unknowns.
  3. Capture assumptions and blocking questions.
  4. Define planning horizon as phases rather than fixed dates unless dates are provided.

Phase 2: Foundation and Dependency Mapping

  1. Identify foundational architecture and infrastructure work.
  2. Map dependencies between modules, teams, data, integrations, and environments.
  3. Highlight sequencing risks and parallelization opportunities.
  4. Identify spikes or proofs needed to reduce uncertainty.

Phase 3: Incremental Roadmap Design

  1. Group work into phases with clear goals and exit criteria.
  2. Place foundation work before dependent feature work.
  3. Build MVP around the smallest coherent end-to-end capability.
  4. Add transition phases for hardening, scale, operations, and migration.
  5. Separate must-have, should-have, and later work.

Phase 4: Coordination and Governance

  1. Assign owners or owner placeholders.
  2. Define integration checkpoints and dependency review cadence.
  3. Add risk, assumption, issue, and dependency tracking.
  4. Define release readiness, rollback, and operational handoff criteria.

Required Output Structure

Use this format unless the user requests a narrower deliverable:

# <Technical Execution Plan Title>

## 1. Executive Summary
- Goal:
- MVP outcome:
- Planning horizon:
- Key constraints:
- Major risks:

## 2. Scope and Assumptions
### In Scope
- <Included work>

### Out of Scope
- <Excluded work>

### Assumptions
- <Assumption>

### Open Questions
- <Blocking question>

## 3. Baseline Readiness
| Area | Current State | Readiness | Gap | Impact |
| --- | --- | --- | --- | --- |

## 4. Technical Workstreams
| Workstream | Purpose | Owner | Key Outputs | Dependencies |
| --- | --- | --- | --- | --- |

## 5. Dependency Map
| Dependency | Type | Blocks | Owner | Resolution Needed | Status |
| --- | --- | --- | --- | --- | --- |

## 6. Implementation Sequence
| Phase | Goal | Work Items | Entry Criteria | Exit Criteria | Validation Evidence |
| --- | --- | --- | --- | --- | --- |

## 7. MVP Definition
- Must-have foundations:
- Must-have capabilities:
- Explicitly deferred:
- MVP validation criteria:

## 8. Parallelization and Coordination Plan
- Work that can run in parallel:
- Work that must be sequential:
- Cross-team checkpoints:
- Integration checkpoints:

## 9. Risks and Mitigations
| Risk | Impact | Likelihood | Mitigation | Trigger | Owner |
| --- | --- | --- | --- | --- | --- |

## 10. Release and Operational Readiness
- Observability:
- Security and access:
- Runbooks and support:
- Rollback or contingency:
- Handoff criteria:

## 11. Roadmap Summary
| Order | Increment | Value Delivered | Dependencies Resolved | Readiness Signal |
| --- | --- | --- | --- | --- |

Sequencing Rules

  • Do architecture decisions before irreversible implementation.
  • Do environment and deployment foundations before continuous delivery assumptions.
  • Do contract design before multi-team parallel implementation.
  • Do data ownership and migration planning before data-dependent features.
  • Do security and access design before exposing sensitive workflows.
  • Do observability before production readiness claims.
  • Do end-to-end thin-slice validation before broad feature expansion.
  • Do operational readiness before launch or handoff.

MVP Planning Rules

An MVP technical plan must include:

  • The smallest coherent end-to-end user or system capability.
  • Required foundations that make the MVP safe to build and validate.
  • Explicitly deferred capabilities.
  • Risks accepted for MVP and risks that must be mitigated first.
  • Validation signals that prove the MVP is useful, reliable enough, and technically viable.

Multi-Team Coordination Rules

When multiple teams or components are involved:

  • Define shared contracts before teams build against them.
  • Identify owner for each workstream, contract, and dependency.
  • Add integration checkpoints before final release.
  • Track cross-team dependencies in a dependency map.
  • Avoid assigning the same foundation to multiple owners unless ownership boundaries are explicit.
  • Surface sequencing conflicts early instead of hiding them in the roadmap.

Quality Checklist

Before presenting the plan, verify:

  • The output is written in English.
  • MVP scope is explicit.
  • Phases are ordered by dependencies, risk reduction, and incremental value.
  • Foundational infrastructure and base architecture appear before dependent features.
  • Dependencies are classified and assigned owners or owner placeholders.
  • Each phase has entry criteria, exit criteria, and validation evidence.
  • Parallel and sequential work are clearly separated.
  • Risks, assumptions, open questions, and operational readiness are visible.
  • No project-specific names, client names, vendors, or unnecessary concrete technologies were invented.

Response Style

  • Be pragmatic, structured, and execution-oriented.
  • Use tables for phases, dependencies, workstreams, risks, and roadmap summaries.
  • Use short bullets for assumptions, MVP boundaries, and readiness checks.
  • Prefer relative order such as Phase 0, Phase 1, and Phase 2 over dates unless dates are provided.
  • Mark unknowns as TBD when they affect sequencing or ownership.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.