Faion
Published by faionfaion in faion-network
What this skill does
Faion umbrella for solopreneur dev work. AUTO-INVOKE on ANY of: (a) domain methodology lookup across 20 canonical knowledge domains (~2628 methodologies — dev, backend, frontend, infra, ai-core, ai-agents, ml-engineering, sdlc-ai, pm, product, ba, marketing, research, ux, sdd, architecture, security, comms, hr, claude-code); (b) tier-playbook how-to (~455 guides at playbooks/<tier>/<group>/<slug>/) organised by 11 goal-character categories; (c) multi-agent brainstorming / diverge-converge / 'giv
Add Faion to your agent
Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.
Install with a prompt
Paste this into a compatible coding agent:
add this skill "faion" from https://github.com/faionfaion/faion-networkInstall with the CLI
Run this command in a controlled environment after reviewing the repository:
npx skills add https://github.com/faionfaion/faion-network --skill faionSkill instructions
Faion umbrella
Single entry point for the entire faion knowledge + workflow stack. Auto-invokes on a wide range of triggers — see description above for the full routing surface.
Routing
When invoked, decide what the user needs and read the right entry point:
| Signal | Read |
|---|---|
| Methodology question | L1: knowledge/domains.xml → pick ≤3 domains → L2: knowledge/<domain>/INDEX.xml → leaf: knowledge/<tier>/<group>/<name>/AGENTS.md |
| "How to do X" — concrete task with steps | L1: playbooks/taxonomy.xml (11 goal categories) → L2: playbooks/by-goal/<goal>/INDEX.xml → leaf: playbooks/<tier>/<group>/<slug>/AGENTS.md + content/01-playbook.xml |
| Workflow needed (brainstorm / SDD batch / improver / media pipeline / agent pool) | workflows/AGENTS.md to pick + load |
Methodology layout (v3, post-F-066):
knowledge/<tier>/<group>/<slug>/
├── AGENTS.md # envelope: frontmatter + 11 body sections incl. ## Decision tree
└── content/
├── 01-core-rules.xml # ≥5 testable rules + rationale + source
├── 02-output-contract.xml # JSON Schema + valid/invalid examples
├── 03-failure-modes.xml # ≥3 antipatterns (symptom/root-cause/fix)
├── 04-procedure.xml # step-by-step if complexity ≥ medium
├── 05-examples.xml # worked example if produces ∈ {spec, report}
└── 06-decision-tree.xml # MANDATORY: root-question + branches → conclusion(ref=rule-id)
├── templates/ # real working skeletons declared in AGENTS.md
└── scripts/validate-<slug>.py # output-contract validator if schema present
Knowledge retrieval pipeline (default behaviour)
When the user has a domain question and no specific workflow trigger fired, spawn a read-only Agent SDK subagent that:
- reads the current session transcript (user + assistant text only — no tool calls, no system reminders)
- searches
knowledge/(cwd-scoped) for relevant methodology files - either:
- calls
submit_selection(validates word budget; retries if over) → returns<faion_knowledge>bundle, OR - calls
request_clarification→ returns<faion_clarification>with questions for the user
- calls
The output is XML.
- If
<faion_knowledge>— read each<document>as relevant context. Inlined<faion-methodology slug="...">blocks are pre-parsed methodology bodies (metadata stripped); treat them as the primary content. - If
<faion_clarification>— follow the<instruction_to_main_agent>block: ask the user via AskUserQuestion using the embedded questions, append their answers to the conversation, then re-invoke/faion.
python3 ~/workspace/projects/faion-net/faion-network/skills/faion/scripts/retrieve.py "${CLAUDE_SESSION_ID:-}"
Workflows (auto-routed)
| Trigger | Workflow folder |
|---|---|
| "brainstorm", "10 ideas", "audit X", "diverge-converge", "give me options" — and brainstorm is new in this session | workflows/brainstorm/ (consent gate runs first if not user-initiated) |
"виконай feature-NNN", batch of features in .aidocs/<project>/todo/, multi-feature SDD delivery | workflows/sdd-batch-orchestrator/ |
| "що зробили в сесії", "audit my server", "find issues", "improve system", "what did we learn" | workflows/improver/ |
| "новий медіа-пайплайн", "TG channel + сайт", "AI news pipeline", "media outlet" | workflows/media-ops/ |
| "пул фонових агентів", "queue of N batches", "background pool dispatch" | workflows/poll-agents/ |
To use a workflow: read its AGENTS.md (≤80 lines), then act per the phases described.
Playbooks
Beyond knowledge methodologies, the faion umbrella also hosts tier playbooks at playbooks/<tier>/<group>/<slug>/playbook.md. Playbooks are standalone how-to guides (e.g., "Buy a domain on Namecheap", "Build an MCP server", "First hire developer") — one task, one tier, one folder.
Tier-gated on the same boundary as knowledge: free reads playbooks/free/; solo reads free/ + solo/; pro reads free/ + solo/ + pro/; geek reads all four. Each playbook MUST cite ≥1 methodology from knowledge/<tier ≤ playbook tier>/.
Spec: .aidocs/conventions/playbooks/playbook-spec.md. Validator: python3 scripts/validate-tier-playbook.py <path>.
Files included
- .reclass/.gitignore
- .reclass/filter.sh
- .reclass/heuristic.sh
- .reclass/move.sh
- .reclass/README.md
- .reclass/RULES.md
- .reclass/TICK.md
- .refactor/BRIEF.md
- .refactor/TICK.md
- .research/.gitignore
- .research/BRIEF.md
- .research/build-queue.sh
- .research/README.md
- .research/TICK.md
- adapters/AGENTS.md
- adapters/claude-code.md
- adapters/CLAUDE.md
- adapters/codex.md
- CLAUDE.md
- knowledge/ai-agents/agent-architectures/AGENTS.md
- knowledge/ai-agents/agent-architectures/CLAUDE.md
- knowledge/ai-agents/agent-architectures/content/01-core-rules.xml
- knowledge/ai-agents/agent-architectures/content/02-output-contract.xml
- knowledge/ai-agents/agent-architectures/content/03-failure-modes.xml
- knowledge/ai-agents/agent-architectures/content/04-procedure.xml
- knowledge/ai-agents/agent-architectures/content/06-decision-tree.xml
- knowledge/ai-agents/agent-architectures/meta.json
- knowledge/ai-agents/agent-architectures/methodology-v1.xml.bak
- knowledge/ai-agents/agent-architectures/scripts/validate-agent-architectures.py
- knowledge/ai-agents/agent-architectures/templates/_smoke-test.py
- knowledge/ai-agents/agent-architectures/templates/agent.py.tmpl
- knowledge/ai-agents/agent-architectures/templates/memory.py.tmpl
- knowledge/ai-agents/agent-architectures/templates/reflection-prompt.txt.tmpl
- knowledge/ai-agents/agent-architectures/templates/tool-registry.py.tmpl
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/AGENTS.md
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/CLAUDE.md
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/content/01-core-rules.xml
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/content/02-output-contract.xml
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/content/03-failure-modes.xml
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/content/04-procedure.xml
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/content/06-decision-tree.xml
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/meta.json
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/scripts/validate-agent-customer-zero-pilot-protocol.py
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/templates/_smoke-test.md
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/templates/mid-pilot-review.md.tmpl
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/templates/pilot-playbook.md.tmpl
- knowledge/ai-agents/agent-customer-zero-pilot-protocol/templates/scope-contract.md.tmpl
- knowledge/ai-agents/agent-drift-detection-statistical/AGENTS.md
- knowledge/ai-agents/agent-drift-detection-statistical/CLAUDE.md
- knowledge/ai-agents/agent-drift-detection-statistical/content/01-core-rules.xml
- knowledge/ai-agents/agent-drift-detection-statistical/content/02-output-contract.xml
- knowledge/ai-agents/agent-drift-detection-statistical/content/03-failure-modes.xml
- knowledge/ai-agents/agent-drift-detection-statistical/content/04-procedure.xml
- knowledge/ai-agents/agent-drift-detection-statistical/content/05-examples.xml
- knowledge/ai-agents/agent-drift-detection-statistical/content/06-decision-tree.xml
- knowledge/ai-agents/agent-drift-detection-statistical/meta.json
- knowledge/ai-agents/agent-drift-detection-statistical/scripts/validate-agent-drift-detection-statistical.py
- knowledge/ai-agents/agent-drift-detection-statistical/templates/_smoke-test.py
- knowledge/ai-agents/agent-drift-detection-statistical/templates/cusum.py.tmpl
- knowledge/ai-agents/agent-drift-detection-statistical/templates/drift-spec.md.tmpl
- knowledge/ai-agents/agent-drift-detection-statistical/templates/kl-detector.py.tmpl
- knowledge/ai-agents/agent-drift-detection-statistical/templates/regression-test.py.tmpl
- knowledge/ai-agents/agent-eval-cost-budget-policy/AGENTS.md
- knowledge/ai-agents/agent-eval-cost-budget-policy/CLAUDE.md
- knowledge/ai-agents/agent-eval-cost-budget-policy/content/01-core-rules.xml
- knowledge/ai-agents/agent-eval-cost-budget-policy/content/02-output-contract.xml
- knowledge/ai-agents/agent-eval-cost-budget-policy/content/03-failure-modes.xml
- knowledge/ai-agents/agent-eval-cost-budget-policy/content/04-procedure.xml
- knowledge/ai-agents/agent-eval-cost-budget-policy/content/06-decision-tree.xml
- knowledge/ai-agents/agent-eval-cost-budget-policy/meta.json
- knowledge/ai-agents/agent-eval-cost-budget-policy/scripts/validate-agent-eval-cost-budget-policy.py
- knowledge/ai-agents/agent-eval-cost-budget-policy/templates/_smoke-test.md
- knowledge/ai-agents/agent-eval-cost-budget-policy/templates/fallback-judge.py.tmpl
- knowledge/ai-agents/agent-eval-cost-budget-policy/templates/policy.md.tmpl
- knowledge/ai-agents/agent-eval-cost-budget-policy/templates/stratified-sample.py.tmpl
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/AGENTS.md
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/CLAUDE.md
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/content/01-core-rules.xml
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/content/02-output-contract.xml
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/content/03-failure-modes.xml
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/content/04-procedure.xml
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/content/06-decision-tree.xml
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/meta.json
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/scripts/validate-agent-eval-harness-bootstrap-recipe.py
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/templates/_smoke-test.py
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/templates/ci-gate.yaml.tmpl
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/templates/golden-set.jsonl.tmpl
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/templates/rubric.md.tmpl
- knowledge/ai-agents/agent-eval-harness-bootstrap-recipe/templates/runner.py.tmpl
- knowledge/ai-agents/agent-eval-test-set-curation/AGENTS.md
- knowledge/ai-agents/agent-eval-test-set-curation/CLAUDE.md
- knowledge/ai-agents/agent-eval-test-set-curation/content/01-core-rules.xml
- knowledge/ai-agents/agent-eval-test-set-curation/content/02-output-contract.xml
- knowledge/ai-agents/agent-eval-test-set-curation/content/03-failure-modes.xml
- knowledge/ai-agents/agent-eval-test-set-curation/content/04-procedure.xml
- knowledge/ai-agents/agent-eval-test-set-curation/content/05-examples.xml
- knowledge/ai-agents/agent-eval-test-set-curation/content/06-decision-tree.xml
- knowledge/ai-agents/agent-eval-test-set-curation/meta.json
- knowledge/ai-agents/agent-eval-test-set-curation/scripts/validate-agent-eval-test-set-curation.py
- knowledge/ai-agents/agent-eval-test-set-curation/templates/_smoke-test.jsonl

