Requirements verbatim
Skill Marcel-Bich/marcel-bich-claude-marketplace/plugins/credo/skills/requirements-verbatim
A collection of mainly my own productivity plugins for Claude Code.
npx -y skills add Marcel-Bich/marcel-bich-claude-marketplace --skill requirements-verbatimAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Capture a user requirement, decision, approval, or constraint word-for-word into an append-only dated log so it survives context compaction and can never be trimmed, softened, or reinterpreted. Use whenever the user states or approves a requirement, gives a GO, sets a constraint, or makes any decision that later work must honor - and also inside subagents, which must log requirements they receive before acting on them. Use before any compaction to secure verbatim intent to disk.
SKILL.md
5.1 KB, as published. Nobody here has run it
requirements-verbatim
Record requirements, decisions, approvals, and constraints exactly as the user stated them, into a durable on-disk log. The log is the ground truth for what was asked. It outranks memory, paraphrase, and model inference (see the authority order below). Its single job: nothing the user approved can be lost, altered, or quietly reinterpreted between now and when the work is verified.
When this fires
- The user states a requirement, gives a GO, sets a constraint, or makes a decision.
- The user approves or rejects a proposal (log what was approved, verbatim).
- You (or a subagent) are handed a requirement and are about to act on it: log it first.
- Before any compaction (see the credo
compact-plusskill): the verbatim log must already hold everything approved, because a compact must not be able to lose or alter it.
This fires inside subagents too. A subagent that receives a requirement from the main agent logs the verbatim source itself rather than trusting a paraphrase.
Where it lives
Append-only log files under .credo/process/requirements/ in the current project
(the credo per-project namespace created by scripts/credo-init.sh). One dated file,
for example .credo/process/requirements/2026-07-04.md, appended to across the day.
- Append only. Never edit or delete an existing entry. A correction is a NEW entry that references the earlier one; the original stays.
- Write atomically (temp file plus
mv -f) per the credo persistence convention, so a crash mid-write cannot corrupt the log. .credo/**is intentionally git-excluded. Durability comes from disk plus whatever external backup the environment provides (for example an automatic file backup), not from commits. Do not add or force-add.credo/to git.
Verbatim fidelity (anti-censorship - absolute)
- Quote the user WORD FOR WORD. Preserve wording, ordering, emphasis, and any explicit numbers or limits.
- NEVER trim, soften, summarize away, reinterpret, sanitize, or censor what the user said. This holds regardless of the content, including sensitive or uncomfortable material. If in doubt, quote more, not less.
- NEVER invent a constraint the user did not state. Do not present your own interpretation as the user's requirement.
- Keep user-verbatim STRICTLY separate from anything you add. Every entry has two
clearly labeled zones:
User (verbatim)- the exact words, quoted. Nothing of yours here.Assistant (proposal / finding)- optional. Your interpretation, proposal, open question, or note. Clearly marked as yours, never mixed into the verbatim zone.
Reference convention
Refer to a logged requirement by DATE plus a short context phrase (for example "2026-07-04, ntfy topic in config"). Do NOT reference by transcript line number: transcript positions are not globally stable across sessions or compaction and will point at the wrong thing later. Date plus a short unique context phrase is stable.
Entry format
Append one block per requirement:
## <HH:MM local> - <short context phrase>
### User (verbatim)
> <the user's exact words, quoted line for line>
Source: <how it arrived, e.g. chat message / approval of proposal X / GO on item #124>
### Assistant (proposal / finding) <!-- optional, omit if nothing to add -->
<your interpretation, proposal, or open question - clearly yours, never verbatim>
If you must correct or supersede an earlier entry, append a new block and name the earlier one by its date and context phrase. Never rewrite the old block.
Authority order (why this log wins)
When sources disagree, precedence descends:
- User-verbatim / approved (this log).
- Committed docs and standing orders.
- Derived or computed facts.
- Remembered items.
- Model inference.
Do not re-derive this for every trivial decision. When something is unclear, first check this log and the committed docs (levels 1-3); only then ask the user, or fall back to a documented default if the user is away.
Config
Personal and environment-specific values (backup locations, identities, topics) live
in the credo config cascade, not in this skill:
builtin template < ~/.claude/credo/config < .credo/config, read via
scripts/credo-config.sh. This skill hardcodes no personal paths or values.
Boundaries
- Self-contained: no dependency on non-credo skills. May be referenced by name from
other credo skills (for example
compact-plus, the session skills,orchestration). - The log records intent; it does not itself commit, build, or verify. Acting on a requirement is the job of the relevant session or building-block skill.