# Zeixcom Cause Effect Tech Writer

> <scope>

- Skill: `tomevault-io/zeixcom-cause-effect-tech-writer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/zeixcom-cause-effect-tech-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/zeixcom-cause-effect-tech-writer/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/zeixcom-cause-effect-tech-writer

---


<scope>
This skill is for the cause-effect library repository. It expects source files at `src/`
and `index.ts`, documentation at the project root, and agent instructions at `.github/`.

For consumer projects using `@zeix/cause-effect` as a dependency, use the `cause-effect`
skill instead.
</scope>

<essential_principles>
**Read source before writing.** Always read the current state of the relevant source file(s)
and the target document before making any changes. Never update from memory.

**Tone adapts to audience.** Each document has a distinct primary reader and register.
See references/tone-guide.md. Violating the tone is as wrong as a factual error.

**Concise over comprehensive.** Every sentence must justify its presence. Cut anything
that does not add information the reader needs. Technical accuracy is non-negotiable;
length is not.

**Surgical edits only.** Update what changed. Do not rewrite sections that are still
accurate, and do not add commentary about what was updated.
</essential_principles>

<intake>
What do you need to do?

1. **Update after a code change** — `src/` or `index.ts` has changed and documents need
   to reflect it
2. **Review consistency** — check that all documents reflect the current source
3. **Update a specific document** — you know exactly which one

**Wait for response before proceeding.**
</intake>

<routing>
| Response | Workflow |
|---|---|
| 1, "code changed", "after change", "just merged", "new feature", "bug fix" | workflows/update-after-change.md |
| 2, "review", "consistency", "check", "audit", "verify" | workflows/consistency-review.md |
| 3, "specific", or names a document | See document routing below |

**Document-specific routing (option 3):**

| Document named | Workflow |
|---|---|
| `README.md` or `GUIDE.md` | workflows/update-public-api.md |
| `ARCHITECTURE.md` | workflows/update-architecture.md |
| `CLAUDE.md` or `copilot-instructions.md` | workflows/update-agent-docs.md |
| `REQUIREMENTS.md` | workflows/update-requirements.md |
| JSDoc / `src/` | workflows/update-jsdoc.md |

**Intent-based routing (clear intent without selecting a number):**
- "document the new API" / "update README" → workflows/update-public-api.md
- "update the architecture doc" → workflows/update-architecture.md
- "update CLAUDE.md" / "add non-obvious behavior" → workflows/update-agent-docs.md
- "update JSDoc" / "inline docs" → workflows/update-jsdoc.md
- "update requirements" → workflows/update-requirements.md
- "review all docs" / "check consistency" → workflows/consistency-review.md

**After identifying the workflow, read it and follow it exactly.**
</routing>

<reference_index>
All in `references/`:

| File | Contents |
|---|---|
| document-map.md | Each document's audience, scope, update triggers, and consistency checks |
| tone-guide.md | Writing tone, register, and conciseness rules per document type |
</reference_index>

<workflows_index>
All in `workflows/`:

| Workflow | Purpose |
|---|---|
| update-after-change.md | Determine which documents to update after a code change, then update them in order |
| update-public-api.md | Update `README.md` and `GUIDE.md` |
| update-architecture.md | Update `ARCHITECTURE.md` |
| update-agent-docs.md | Update `CLAUDE.md` and `.github/copilot-instructions.md` |
| update-requirements.md | Update `REQUIREMENTS.md` |
| update-jsdoc.md | Update JSDoc comments in `src/` |
| consistency-review.md | Review all documents for consistency with current source |
</workflows_index>

---
> Source: [zeixcom/cause-effect](https://github.com/zeixcom/cause-effect) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->