the-own-lab/write-brief
skills/write-brief/SKILL.md
Update BRIEF.md sections during a command run. Any skill that produces a brief-persisted artifact calls this to write it back.
documentation
Updated Apr 23, 2026
$ install --global
skillsauthnpx skillsauth add the-own-lab/Claude-company-of-one write-briefInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 23, 2026, 7:53 AM127.4s1 file scanned
SKILL.md
- name:
- write-brief
- description:
- Update BRIEF.md sections during a command run. Any skill that produces a brief-persisted artifact calls this to write it back.
write-brief
Purpose
In-session updater for BRIEF.md. Skills that produce findings, decisions, open
questions, or human-owned-core content use this skill to persist them to the brief
so later skills in the chain see the same source of truth (ADR-001 D2).
Inputs
- The current brief returned by
brief-manager.sh path(${COMPANY_OF_ONE_PLUGIN_DATA}/projects/<key>/sessions/<session-id>/BRIEF.md). - A target section name (
Open Questions,Assumptions,Current Contract,Human-Owned Core, etc.). - The content to replace under that section.
Outputs
- Updated
BRIEF.mdwith the requested section modified. No other section touched.
Procedure
- Get brief path via
bash "hooks/scripts/lib/brief-manager.sh" path. - Read the file with Read.
- Locate the target
##heading. Preserve all other sections verbatim. - Apply the update via the Edit tool by replacing that section's body. Append only for short list sections where the new entry is not already represented.
- Never paste raw diffs, full test logs, terminal transcripts, or copied source docs.
- Never remove a section; empty a section by replacing with a single
-bullet if needed. - Run
bash "hooks/scripts/lib/brief-manager.sh" check-budget.
Failure modes
- Brief not found → the calling command never ran
read-brief. Stop and report. - Target section not present in the brief → template drift; stop rather than invent a section.
- Would modify
## Relevant Memoryor## Ignored Memory→ refuse; onlyread-briefwrites those. check-budgetfails → shrink or summarize the updated section before continuing.
Does not do
- Does not read MEMORY.md.
- Does not re-scaffold the brief; that is
brief-manager.sh init. - Does not archive or finalize;
update-docstriggers archive at command end.
Related Skills
the-own-lab/verify
development
VerifiedTrustedCommunity
Post-code check: run tests + confirm TODO acceptance items map to passing tests; applies a security lens but is not a separate scan.
SKILL.mdUpdated Apr 22, 2026
the-own-lab/update-docs
documentation
VerifiedTrustedCommunity
Command post-step: write CHANGELOG + TODO once per command run. One call, not per-skill doc writes.
SKILL.mdUpdated Apr 22, 2026
the-own-lab/spec-writing
content-media
VerifiedTrustedCommunity
Author REQUIREMENTS.md + DESIGN.md + TODO.md for a feature. The three files are one contract; they ship together.
SKILL.mdUpdated Apr 22, 2026
the-own-lab/spec-conformance
testing
VerifiedTrustedCommunity
/review Layer 1 auditor + /think self-review. Three contexts: think-self-review, review-spec, review-implementation. Also judges reconstruction drills.
SKILL.mdUpdated Apr 22, 2026