---
name: ifstory
description: Run the IF.story protocol when the user says `ifstory`, `if.story`, or asks to write session articles; generate the full bundle of Authentic, Medium, and Chronicle outputs each time.
version: 2.3.0
homepage: https://infrafabric.io/skill/ifstory
---

# IF.story Skill

Use this skill when the user explicitly invokes `ifstory` or `if.story`, or when they ask to "write your articles" using the IF.story narrative workflow.

## Source Of Truth

- Bundled protocol reference: `references/IF.story.md`

Read the bundled protocol before acting. If the user also provides a newer IF.story prompt in their own repo, prefer that newer local source and keep the bundle behavior the same.

## Required Behavior

- Every invocation generates all three outputs:
  - `AUTHENTIC`
  - `MEDIUM`
  - `CHRONICLE`
- Use the session's real constraints, file paths, commands, and uncertainty.
- Do not collapse the bundle into a single summary.
- End with the manifest JSON required by the protocol.

## Output Location Discovery

Do NOT hardcode output paths. Use this priority:

1. If the user specifies a path, use that.
2. If the current project/repo has `docs/narrations/`, use it.
3. If `~/docs/narrations/` exists, use it.
4. Otherwise, create `docs/narrations/` in the current working directory.

Subdirectories within the chosen root:
- `sessions/` for AUTHENTIC
- `articles/` for MEDIUM
- `chronicles/` for CHRONICLE

**Always announce the chosen output path to the user before writing.**

## Minimal Workflow

1. Read `references/IF.story.md`.
2. Capture the session inputs: date, model, mission, friction, confidence, context audit.
3. Discover the output location (see above).
4. Write `AUTHENTIC` first.
5. Derive `MEDIUM` from the authentic record.
6. Write `CHRONICLE` last, grounded in the session's actual twist or reversal.
7. Save files using the protocol naming convention.
8. Output the manifest JSON.

## Guardrails

- No fake positivity.
- No performed humility.
- If one of the three forms feels weak, state the limitation directly and still generate it.
- Keep the three-output bundle invariant even when adapting to a different repository layout.
