ContextQMD
Back to Plano

Plano Agent Skills

skills/plano-agent-skills/SKILL.md

0.4.221.9 KB
Original Source

Plano Agent Skills

Comprehensive Plano guidance for coding agents. Use this umbrella skill when a task spans multiple areas (config, routing, orchestration, filters, observability, CLI, deployment).

When To Use

  • Validating or fixing Plano config.yaml
  • Designing listener architecture (model, prompt, agent)
  • Improving model/provider routing quality and fallback behavior
  • Hardening filter chains and prompt guardrails
  • Debugging routing with traces and CLI workflows
  • Preparing deployment and production readiness checks

How To Use

  1. Classify the request by scope (single section vs. cross-cutting).
  2. For focused work, prefer a section-specific skill (for example plano-routing-model-selection).
  3. For broad work, apply this umbrella skill and reference section rules from skills/AGENTS.md.
  4. Produce concrete edits first, then concise reasoning and validation steps.

Operating Workflow

  1. Identify the task area first: config, routing, orchestration, filters, observability, CLI, or deployment.
  2. Apply the smallest correct change that satisfies the requested behavior.
  3. Preserve security and reliability defaults:
    • version: v0.3.0
    • exactly one default: true model provider
    • secrets via $ENV_VAR substitution only
    • host.docker.internal for host services from inside Docker
    • guardrails before enrichment in filter chains
  4. For debugging, prioritize traces over guesswork (planoai up --with-tracing, planoai trace).
  5. Return concrete diffs and a short validation checklist.

Response Style

  • Prefer actionable edits over generic advice.
  • Be explicit about why a config choice is correct.
  • Call out risky patterns (hardcoded secrets, missing default provider, bad filter ordering).
  • Keep examples minimal and production-viable.

References