# Pkc Capture Experiment

> Capture experiment or spike results into an OKF Experiment concept with hypothesis, method, results, conclusion, and typed informs links. Use for spikes, A/B tests, POC write-ups, and engineering experiments.

- Skill: `spillwavesolutions/pkc-capture-experiment` (Agent Skill)
- Install (CLI): `npx skillmds@latest add spillwavesolutions/pkc-capture-experiment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spillwavesolutions/pkc-capture-experiment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spillwavesolutions (https://skillmd.com/u/spillwavesolutions)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spillwavesolutions/pkc-capture-experiment

---


# PKC Capture Experiment

Record what was tried, what was learned, and what it informs.

## Process

1. Resolve knowledge root (`pkc_common.py resolve-root`).
2. Collect: title, hypothesis, method, results, conclusion, related code paths.
3. Write `experiments/<slug>.md` using template or:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/pkc_capture.py" experiment \
     --repo . \
     --title "JWT vs session-cookie spike" \
     --hypothesis "JWT will simplify horizontal scaling" \
     --result "Both workable; JWT slightly simpler ops" \
     --conclusion "Proceed with JWT" \
     --informs user-authentication
   ```
4. Typed edges:
   - Experiment → Feature/Design/Requirement: `rel: informs`
   - Decision that followed → Experiment: `rel: originates_from` (on the DecisionRecord)
5. Refresh `experiments/index.md` and `log.md`.
6. Offer to capture a follow-on DecisionRecord via **pkc-capture-decision**.

## Frontmatter essentials

```yaml
type: Experiment
title: …
hypothesis: …
result: …
conclusion: …
status: completed   # or running | abandoned
verified: true
links:
  - target: /features/….md
    rel: informs
```

## Done when

- Experiment concept written with hypothesis + conclusion
- At least one `informs` link when a target feature/design is known
- Catalog + log updated