context-writing

Writes and maintains knowledge-base facts using one-fact-one-home placement and a review-flip lifecycle.

1|1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/growmax/growmax-skills --skill context-writing-growmax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: context-writing
Source: https://github.com/growmax/growmax-skills/tree/main/gmax/skills/context-writing
Command: npx skills add https://github.com/growmax/growmax-skills --skill context-writing-growmax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of project knowledge when facts are duplicated across documents, written without review, or forced into a structure that does not match the project's own conventions. This Skill enforces a disciplined lifecycle for how facts enter and live in a project's knowledge base. ## Core Features & Use Cases - One-fact-one-home placement: Every fact lives in exactly one file, placed according to the project's own KB structure (never an imposed taxonomy), with other documents linking to it. - Direct-write + review-flip lifecycle: Agent-derived facts are written once with Status: Pending review, then flipped to Confirmed after human review; developer-stated facts are written directly as Confirmed. - Index and commit discipline: KB index files are updated on every add/rename/status change, and files are committed to git only when they become Confirmed. - Use Case: After code recon reveals that the billing module retries failed payments three times, write that fact into the module's KB doc marked Pending review, link it from the index, and tell the developer exactly which file to confirm. ## Quick Start Use the context-writing skill to record this newly discovered fact in the project's knowledge base following its existing structure and status conventions.

Frequently Asked Questions about context-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write facts into a project knowledge base without duplication?▼

Place each fact in exactly one file following the project's own KB structure, and link to it from other documents. Read the KB's index or README first to determine placement, and never create a folder or document before its first real fact exists.

How does the Pending review to Confirmed lifecycle work?▼

Agent-derived facts are written once directly into their KB home marked Status: Pending review, then flipped to Confirmed after human review. Developer-stated facts skip review and are written directly as Confirmed since the developer is the authority.

When are knowledge-base files committed to git?▼

A KB file is committed at the moment it becomes Confirmed, with a docs(context) commit staging exactly those files. Pending-review files stay uncommitted by default so git never carries unverified information.

What should not go into the business knowledge base?▼

Engineering build conventions such as folder placement rules, dependency direction, styling systems, and known mistake classes belong in a standards/ directory, not the business KB. The KB holds domain facts, not engineering policy.

What happens when a new fact contradicts an existing document?▼

Do not merge the contradiction silently. Report the conflict to the human so they can decide which statement is true, then edit the correct fact in place.