Using Pips
Pips are small coloured indicator dots that appear on nodes in the document tree. They are the universal feedback surface in Writan — all feedback, from every source, surfaces through pips.
Pip Types
| Colour | Source | Meaning | Status |
|---|---|---|---|
| 🟧 Orange | Craft engine | Ruleset violation — a writing rule has been triggered | Implemented |
| 🔴 Red | Tutor | Load-bearing dramatic gap — something structurally important is missing | Planned |
| 🟠 Amber | Tutor | Enrichment opportunity — could be stronger | Planned |
| 🔵 Blue | Tutor | Continuity flag — a consistency concern | Planned |
| 🟣 Purple | AI generation | Generation note — something to review from AI output | Planned |
| 🟢 Green | Resolved | Dismissed or answered | Implemented |
Currently, only craft pips (orange) are generated by the system. Tutor pips and generation pips are planned for future releases.
Responding to Pips
When you see a pip on a node:
- Click the node to select it
- Review the pip detail in the Properties panel or pip popup
- Take action:
- Answer the question or address the issue
- Dismiss with a reason (deliberate choice, not applicable, revisit later)
Dismissal Reasons
When dismissing a pip, you choose a reason:
- Answered — you’ve addressed the concern
- Deliberate — you’re aware of it and it’s intentional
- Not applicable — doesn’t apply to your work
- Revisit — you want to come back to it later
Dismissals are recorded in both the pips table and the node’s generation.decisions array for a full audit trail.