night-market-docs-and-writing

Featured

Maintain docs of record, ADRs, changelog, and house style. Use when writing repo docs. Do not use for release steps; use night-market-operations instead.

AI & Automation 339 stars 35 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
84
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Night Market Docs and Writing This skill maps every document of record in claude-night-market, states which are hand-authored and which are generated, and gives the house prose style with the commands that enforce it. "Docs of record" means the files other contributors treat as canonical truth. Editing the wrong file (or a generated one) creates drift that CI then flags. ## Docs-of-record map | File | Canonical for | Authored or generated | Update trigger | |------|---------------|-----------------------|----------------| | `CONSTITUTION.md` | Supreme law: 10 non-negotiable rules | Hand-authored | Amendment PR titled `constitution: amend rule N` plus repo-owner sign-off | | `STEWARDSHIP.md` | Values and virtues behind the rules | Hand-authored | Rarely; value-level shifts only | | `.claude/rules/` (8 files) | Repo-wide behavioral rules loaded into every session | Hand-authored | A research finding or audit graduates into policy | | `docs/adr/` (0001-0017) | Load-bearing decisions with status and supersession | Hand-authored | New architectural decision; supersede, never rewrite | | `docs/quality-gates.md` | Three-layer gate system and skill gate composition | Hand-authored | Gate or threshold changes | | `docs/testing-guide.md` | Test discipline and coverage practice | Hand-authored | Testing policy changes | | `docs/plugin-development-guide.md` | Plugin authoring, release checklist, Python tiers | Hand-authored | Plugin conventions change | | `docs/skill-description-gui...

Details

Author
athola
Repository
athola/claude-night-market
Created
10 months ago
Last Updated
2 days ago
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

docs-style

How a document is written — what it opens with, how it is structured, and which sentences do not belong. TRIGGER when: writing, revising, restructuring or reviewing any long-form prose this repo or a project keeps — a docs/ page, a README section, a learnings file, a convention version README, a memory file body, or a comment running past a few lines. Invoke BEFORE the first draft, not after. DO NOT TRIGGER when: the question is whether a document is still true or complete (that is `docs-relevance`), the text is a commit message (`shared/commit-message-rules.md`), or the subject is how Claude's chat replies are shaped (that is the output style, tuned through `tune-output`).

1 Updated today
AnotherSava
Data & Documents Listed

writing-documentation

Use when writing or updating a README, project docs, an architecture decision record, a changelog, API docs or code comments, or when a change alters behavior, setup or commands that docs describe

0 Updated today
rkaliev
AI & Automation Listed

docs-standards

Fabrizio's documentation conventions for a repository's docs/ tree. Consult this whenever writing or maintaining docs in one of his repos — adding or changing an ADR, plan, runbook, or reference doc; updating a README index; recording an architectural decision; retiring a completed plan; or scanning for stale docs at session end. Covers the Diátaxis directory split (decisions, plans, runbooks, reference), the Nygard ADR format, the ephemeral two-PR plan lifecycle, keeping every README index current in the same commit, the agent-directed and verify callouts, and a session-end doc-maintenance checklist. Relies on the markdown-standards skill for how the Markdown itself is written. Complements the repo's own CLAUDE.md rather than overriding it.

0 Updated 4 days ago
flungo