# Lcp Wysiwid Spec

> Write WYSIWID-style design docs (Concepts + Synchronizations) for go-lcpd, keeping terminology consistent with code. Use when this capability is needed.

- Skill: `tomevault-io/lcp-wysiwid-spec` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/lcp-wysiwid-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lcp-wysiwid-spec/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/lcp-wysiwid-spec

---


Use this skill when you are authoring or updating `go-lcpd` design documentation (the “What You See Is What It Does” / WYSIWID pattern).

## References (in-repo)

- `go-lcpd/WhatYouSeeIsWhatItDoes.md` (background and rationale)

## WYSIWID model (summary)

- A **Concept** is an independent capability. Concepts must not depend on each other.
- A **Synchronization** connects Concepts into an end-to-end flow/story.

## Writing rules (must follow)

- Start with invariants (“Security & Architectural Constraints”). Use RFC 2119 language (MUST / MUST NOT) and include brief rationales.
- Keep Concepts dependency-free:
  - A Concept MUST NOT call actions from other Concepts.
  - A Concept MUST NOT reference other Concepts’ types.
  - Cross-Concept coordination belongs only in Synchronizations.
- Keep structure flat and scannable; prefer short lists, signatures, and data-shape bullets over long prose.
- Use a ubiquitous language: keep terminology consistent across docs and Go identifiers where possible.

## Suggested section order (for `spec.md`)

1. Security & Architectural Constraints
2. Concepts
3. Synchronizations

## Example template (shape)

- `### <ConceptName>`
  - Purpose: …
  - Domain Model: `Thing: field, field`
  - Actions: `action(arg) -> out` (include side effects + error cases)

- `### sync <SyncName>`
  - Summary: …
  - Flow: when / where / then (include error branches)

If the flow is complex, add a Mermaid sequence diagram or state chart.

## Validation

- Ensure the doc can be read as the “ubiquitous language” for the relevant code.
- If the doc implies behavior changes, implement them and validate with the module’s normal test/lint flow (see `$lcp-go-lcpd`).

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/yusukeshimizu) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->