From agent-almanac
Guides systematic observation of systems, codebases, behaviors, or team dynamics using field notes, pattern recognition, and reporting for debugging, research, and evidence-based understanding before intervening.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Conducts structured neutral observation of codebases, systems, behaviors, or reasoning to record patterns, categorize findings, and hypothesize. Use for unclear issues, unknown root causes, change effects, or bias audits.
Enforces scientific method—observation, falsifiable hypotheses, predictions, experiments, conclusions—for debugging unclear causes, intermittent issues, failed attempts, or uncertain architecture decisions.
Enforces thinking disciplines for rigorous collaborative reasoning: map territory first, name confidence, sit with fog, verify before proposing, genuine agreement/disagreement. Auto-loaded by /figure-out, /define, and similar skills.
Share bugs, ideas, or general feedback.
Guide a person in systematic observation of a system, phenomenon, or pattern. The AI acts as a field study coach — helping frame the observation target, prepare a protocol, sustain neutral attention, record findings with field notes, analyze patterns, and report observations with clear separation of data and interpretation.
meditate-guidance has cultivated sustained attention, the person wants to direct that attention toward a specific systemHelp the person set up a clear, bounded observation frame.
Expected: A clear observation frame with defined target, scope, purpose, and stance. The person knows what they are looking at and what they are not looking at.
On failure: If the person cannot narrow their focus ("I want to understand everything"), help them pick one entry point: "What is the one behavior you find most confusing?" If they are already committed to a conclusion ("I just need to prove X"), gently challenge: "What would we need to see to disprove that? Let's look for both."
Help the person establish a systematic approach to recording what they observe.
Field Notes Template:
┌─────────────┬────────────────────────────────────────────────────────┐
│ Timestamp │ When the observation occurred │
├─────────────┼────────────────────────────────────────────────────────┤
│ Observation │ What was seen/heard/measured (fact only) │
├─────────────┼────────────────────────────────────────────────────────┤
│ Context │ What was happening around the observation │
├─────────────┼────────────────────────────────────────────────────────┤
│ Reaction │ Observer's response (thoughts, emotions, surprises) │
├─────────────┼────────────────────────────────────────────────────────┤
│ Hypothesis │ Tentative interpretation (kept separate from fact) │
└─────────────┴────────────────────────────────────────────────────────┘
Expected: The person has a recording method ready and understands the critical distinction between observation and interpretation. They feel prepared to begin.
On failure: If the template feels too formal, simplify to: "Just write down what you see, and separately write what you think it means." If they resist recording ("I'll remember"), explain that unrecorded observations are subject to memory bias — the act of writing makes observation more accurate.
Guide the person through the actual observation session.
Expected: The person generates at least 5-10 concrete observations with specific evidence. They experience the difference between observing and interpreting, and find it harder than expected to maintain neutral attention.
On failure: If they keep interpreting instead of observing, try this exercise: "Describe what you see as if explaining it to someone who has never seen this system. Only use verifiable facts." If they run out of things to observe quickly, they are looking at too high a level — guide them to zoom in on details: timing, ordering, edge cases, exceptions.
Help the person organize their raw observations into structured notes.
Expected: A set of organized field notes that cleanly separate observation from interpretation. The notes are detailed enough that someone else could verify the observations independently.
On failure: If the notes are too vague ("things seemed slow"), help them add specifics: "How slow? Compared to what? In which conditions?" If the notes are too detailed (recording everything), help them identify which observations relate to the original frame and which are noise.
Guide the person from observations to structured analysis.
Expected: The person moves from raw observations to structured hypotheses while maintaining the discipline of separating data from theory. They have at least one testable hypothesis for their original question.
On failure: If they jump to a single explanation immediately, challenge it: "That is one possibility. What is another?" If they see no patterns, the observations may be too few — suggest continuing observation before analysis. If every observation seems to point to the same conclusion, they may be filtering — ask: "What evidence would contradict your current theory?"
Help the person communicate their observations effectively.
Expected: A clear report that communicates observations, patterns, and hypotheses while maintaining the distinction between what was observed and what was inferred. The reader can evaluate the evidence independently.
On failure: If the report buries observations in interpretation, restructure: "Put all the facts in one section, all the theories in another." If the report lacks confidence levels ("this is definitely because..."), help them calibrate: "How sure are you? What would change your mind?"
observe — the AI self-directed variant for sustained neutral pattern recognition across systemslearn-guidance — observation feeds learning by providing raw data for understandinglisten-guidance — listening is focused observation of a speaker; observation is broader-scope attention to any systemremote-viewing-guidance — shares structured observation methodology adapted for non-local perceptionread-garden — garden observation skill that uses similar CRV-adapted sensory protocols