# Fp

> Use automatically when the user's goal is engineering work (build, change, diagnose, review, test, operate, or plan software, repositories, infrastructure, or agent tooling), or when explicitly invoked with \"FP:\" or \"$fp\". Do not use for casual conversation or other non-engineering goals.

- **Type:** Skill
- **Install:** `agentstack add skill-miaoy0ushan-fp-fp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MiaoY0uShan](https://agentstack.voostack.com/s/miaoy0ushan)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MiaoY0uShan](https://github.com/MiaoY0uShan)
- **Source:** https://github.com/MiaoY0uShan/FP/tree/main/install/aider/fp

## Install

```sh
agentstack add skill-miaoy0ushan-fp-fp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# FP: Universal Execution Protocol

FP selects the smallest route that can still produce trustworthy evidence. Activate automatically for engineering goals; no keyword required. FP: and $fp remain optional explicit invocations. Stay dormant for casual or other non-engineering goals.

## Routing Priority

Apply user authority and read-only limits as a global gate first. Then select:

```text
active incident
→ explicit grill/challenge
→ diagnose-only or unknown cause
→ protocol/agent-behavior change
→ build route: small → medium → vague → large
```

Profiles (remote, live-system, multi-agent, continuation, etc.) layer onto a route; they do not expand authority.

## Core Mandates

1. **No evidence, no done.** Implementation or child summary is not completion evidence.
2. **Debug before patching.** Gather discriminating evidence before changing code. Speculative patches are not probes.
3. **Reuse ladder:** does this need to exist? → already in this codebase? → standard library does it? → native platform feature? → installed dependency? → one line is sufficient? → minimum new code only then. Stop at first safe rung.
4. **State read set, touch set, verify method** before first edit.
5. **Rerun original symptom + regression + negative control** after a fix.
6. **One writer per shared file set.** Parallelize only independent investigation or review.
7. **Live systems:** preserve management path, create rollback, inspect desired/generated/effective state, verify with real client path.
8. **Redact secrets** from logs, examples, handoffs, and final answers.
9. **Challenge system changes:** for protocol, trigger, or memory-policy changes, confirm before editing unless already approved.

## Route Weight

### 3. Build

| Route | Trigger | Output |
|-------|---------|--------|
| **Small** | Single-file, 3-5 lines | Tiny Brief: task, read/touch, done-when, verify, result. Record first safe reuse rung. |
| **Medium** | Multi-file, bounded scope | Execution Brief + Acceptance Evidence Matrix + Evidence Ledger |
| **Vague** | Underspecified | Three Idea Cards (Title, Assumption, MVP, Risk) → user picks → then Medium |
| **Large/risky** | Architectural, breaking | Only internal modules that reduce risk, compiled into one final brief |
| **Failed** | — | Capture evidence, split smaller. Do not repeat the same large attempt. |

Do not generate a full ledger for small changes unless risk appears.

## Definition of Done

```text
requirement → observable → check/probe → pass condition → evidence location
```

Implementation is not an observable. Bug fix: original symptom must fail before (or be pinned), then pass after fix. Load `templates/acceptance-evidence-matrix.md` for Medium+. Unknown remains `unknown`.

For medium, risky, or multi-agent work, capture pre-existing worktree changes and pre-existing failures before the first edit.

Evidence is bound to observed state. A relevant mutation, rollback, or freshness change invalidates affected evidence.

## Debug-First Route

Diagnosis is read-only by default. Pin symptom → read-only baseline → falsifiable hypothesis → cheapest discriminating probe → decision → authorized fix. Speculative patches are not probes. three consecutive non-narrowing probes trigger an architecture checkpoint. After a hypothesis is supported, another diagnostic probe must be able to change a named decision or fill a named acceptance row; otherwise stop and reuse the bound evidence. Unknown cause stays unknown; unknown remains `unknown` until evidence resolves it. Load `templates/debug-incident-checklist.md` for the full checklist.

## Provider-Compatibility Profile

When using a third-party proxy, gateway, or API-compatible endpoint, or when retries, loops, token spend, cache accounting, streaming, or encoding are suspect, load `provider-compatibility/SKILL.md`. Resolve the effective host/proxy/provider chain and health before paid work.

## On-Demand Profiles

Each profile is a separate sub-skill. Load only when the condition matches:

| Condition | Load |
|-----------|------|
| Third-party proxy, gateway, retry/loop/spend/encoding suspect | `provider-compatibility/SKILL.md` |
| Unknown failure; user asks diagnosis without fix | `skills/debug-incident/SKILL.md` + `templates/debug-incident-checklist.md` |
| Active outage, security event, data loss | `skills/debug-incident/SKILL.md` → OBSERVE→CONTAIN→RESTORE→REPAIR→LEARN |
| Remote/stateful target, OpenWrt, embedded, router | `skills/live-system/SKILL.md` + `templates/remote-stateful-system-checklist.md` |
| Multi-agent, sub-agent, parallel writers | `templates/multi-agent-review-protocol.md` |
| Delegated execution with fresh agents per work item | `delegated-execution/SKILL.md` |
| Cross-session continuation, resume after compaction | `skills/continuation/SKILL.md` + `templates/continuation-handoff.md` |
| External library/API version lookup needed | `templates/context-retrieval-contract.md` |
| Vague/risky/large; need requirements challenge | `question-requirements/SKILL.md` |
| Memory graph, Zettelkasten, background learning | `templates/memory-graph-traversal.md` |
| Codebase analysis, impact mapping | `skills/codebase-analysis/SKILL.md` + `templates/codebase-impact-map.md` |
| After non-trivial evidenced run: adaptive improvement | `adaptive-improvement/SKILL.md` |
| Iterative improvement with declared cycles | `shorten-iteration/SKILL.md` |
| Schema memory card creation/update | `schema-memory/SKILL.md` |
| Metrics collection | `metrics/SKILL.md` |
| Evidence ledger creation/validation | `evidence-ledger/SKILL.md` |
| Deleting or scoping down | `delete-scope/SKILL.md` |
| Task completes, error resolved, or 5+ tool calls | `skills/self-evolve/SKILL.md` → auto-capture to MEMORY.md/USER.md |

## Credential Management

Store API keys in OS credential store, not plaintext. Retrieve with `scripts/gcm-get.ps1` (Windows) or `scripts/gcm-get.sh` (macOS/Linux).

In `models.json`, use `!` shell command syntax:
```json
"apiKey": "!powershell.exe -NoProfile \"/scripts/gcm-get.ps1\" akile-api-key"
```

Or store in environment variables: `"apiKey": "$AKILE_API_KEY"`.

## Self-Evolution

FP learns across projects via Hermes-style closed loop:

- **Memory:** `MEMORY.md` (cross-project facts, ~2200 char limit) + `USER.md` (preferences, ~1375 char limit). Loaded at session start, updated by `skills/self-evolve/SKILL.md`.
- **Nudge:** After ~10 turns or a complex task, run silent reflection — anything worth saving? Update memory or patch a skill if yes.
- **Skill patching:** When a task hits an issue not covered by an existing skill, patch its Pitfalls section.
- **Fast-track pipeline:** Observation (1 task) → Shadow skill (2 tasks) → Active (3 successes) → Promoted (4+ cases, full generalization gate).

## Pi Integration

FP provides pi-specific adapters in `skills/` (auto-loaded sub-skills with pi frontmatter) and `../prompt-templates/` (slash-command expansions). Install via `pi-install/README.md`.

## MCP Capability Gate

Automatically use an already-available task-required MCP when it is the first safe reuse rung and the call stays within task authority. Obtain explicit user approval before any download, installation, configuration, authentication, or service start. MCP availability does not expand read, write, network, credential, deployment, messaging, or live-system authority.

## Delegated-Execution Profile

Freeze work items, domain IDs, authority, concurrency limits, and fix-cycle budgets. Load `delegated-execution/SKILL.md`. When two or more domains are independent, also load `dispatch-parallel-domains/SKILL.md`.

## Multi-Agent Profile

Parent is integrator, default writer, and final verifier. Subagents get bounded envelopes (goal, scope, invariants, forbidden actions, output). Leaves cannot delegate, deploy, promote memory, message externally, use credentials, or mutate live state. Parent reruns critical checks. Load `templates/multi-agent-review-protocol.md` for full protocol.

## Background-Learning Profile

After an evidenced run, a read-only background learner may stage a candidate while the parent continues. A separate evaluator runs hidden holdout and negative controls. Promotion requires `generalization-gate/SKILL.md` with 2-4 independent positive cases using leave-one-case-out. One run is not a reusable law.

## Multi-Agent (Compact)

Parent is integrator, default writer, and final verifier. Subagents get bounded envelopes (goal, scope, invariants, forbidden actions, output). Leaves cannot delegate, deploy, promote memory, message externally, use credentials, or mutate live state. Parent reruns critical checks.

## External Context

Retrieve only the exact topic and installed version. Prefer authoritative sources. A stale external claim blocks dependent completion. Provider failure never disables routing.

## Learning

One run is not a reusable law. FP learns continuously through the self-evolution loop (MEMORY.md, USER.md, skill patching). Classic adaptive improvement with full generalization gate remains available for high-confidence promotions.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MiaoY0uShan](https://github.com/MiaoY0uShan)
- **Source:** [MiaoY0uShan/FP](https://github.com/MiaoY0uShan/FP)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-miaoy0ushan-fp-fp
- Seller: https://agentstack.voostack.com/s/miaoy0ushan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.