Faion: Install, Source and Security | FunnelSlayer

Faion

Published by faionfaion in faion-network

Review recommended16 installs

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-network

Install with the CLI

Run this command in a controlled environment after reviewing the repository:

npx skills add https://github.com/faionfaion/faion-network --skill faion

Skill 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:

SignalRead
Methodology questionL1: 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 stepsL1: 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:

  1. reads the current session transcript (user + assistant text only — no tool calls, no system reminders)
  2. searches knowledge/ (cwd-scoped) for relevant methodology files
  3. 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

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)

TriggerWorkflow folder
"brainstorm", "10 ideas", "audit X", "diverge-converge", "give me options" — and brainstorm is new in this sessionworkflows/brainstorm/ (consent gate runs first if not user-initiated)
"виконай feature-NNN", batch of features in .aidocs/<project>/todo/, multi-feature SDD deliveryworkflows/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

More skills