me2resh/apexyard / .claude/skills/journey
journey
VerifiedSelf-contained HTML user-journey map (boxes/arrows with per-page modals) — preview between PRD and tech-design.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 23.1 KB |
| fixtures/sample-checkout.yaml | config | 1.7 KB |
| tests/README.md | markdown | 2.1 KB |
| tests/render_smoke.py | script | 24.5 KB |
tests/README.md
View on GitHub# /journey smoke test
Standalone Python script that renders the canonical fixture YAML to HTML using
the algorithm documented in `../SKILL.md`. Lets us verify on every change that:
- the YAML schema is parseable
- BFS layout produces sane box positions
- the HTML output is self-contained (no external CSS / JS / fonts)
- modals and boxes are emitted for every page
- transition labels render
This is a v1 smoke test, not a comprehensive renderer. The skill itself runs
inside Claude Code's environment and writes HTML directly via `Write`; this
script exists so a human or CI job can confirm the algorithm hasn't regressed.
## Run
From the apexyard fork root:
```bash
python3 .claude/skills/journey/tests/render_smoke.py
```
Defaults to:
| Input | Output |
|-------|--------|
| `.claude/skills/journey/fixtures/sample-checkout.yaml` | `/tmp/sample-checkout.html` |
Or pass explicit paths:
```bash
python3 .claude/skills/journey/tests/render_smoke.py path/to/journey.yaml /tmp/out.html
```
Exit code: `0` on success, `1` on any validation or rendering failure. The
script prints `OK: rendered N pages, M transitions to <path>` on success.
## Browser check
After running, open the output in your browser to verify modals open and close:
```bash
open /tmp/sample-checkout.html # macOS
xdg-open /tmp/sample-checkout.html # Linux
```
Expected behaviour:
- Three boxes (Cart, Payment, Confirmation) connected by two arrows
- Click any box → modal opens with the page's contents, transitions in/out
- Press Escape, click the backdrop, or click the × button → modal closes
- Tab navigates between boxes; Enter / Space opens the focused box's modal
Tested in Chrome, Safari, and Firefox on macOS — all three render the journey
identically and handle modals correctly.
## Dependencies
PyYAML if available; falls back to a minimal YAML subset parser sufficient for
the fixture if PyYAML is absent. No other runtime dependencies — vanilla Python
3.8+.
---
*Part of [ApexYard](https://github.com/me2resh/apexyard) — multi-project SDLC framework for Claude Code · MIT.*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |