scarletkc/seiso
A Markdown convention and linter for project docs written by AI and read by humans and agents
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
A Markdown convention and linter for project docs written by AI and read by humans and agents. [](https://github.com/scarletkc/seiso/actions/workflows/ci.yml) [](https://crates.io/crates/seiso) [](https://pypi.org/project/seiso/) [](https://www.npmjs.com/package/@scarletkc/seiso) [](https://github.com/scarletkc/seiso/blob/main/LICENSE) [](https://coderabbit.ai) [](https://deepwiki.com/scarletkc/seiso) AI writes project docs faster than anyone can review them, and coding agents read those docs back as context for the next change. People and agents alike take the page at its word, so a stale version number or a field list updated in only one of its three copies misleads all of them. And AI makes the same few mistakes over and over. seiso defines one convention for how Markdown in a repository is organized, the way rustfmt settled formatting for Rust code. Projects share the rules instead of negotiating their own; each project mainly maps its documents to kinds, and seiso init suggests a starting point. and holds only what that kind is for. A how-to gives the steps. Why the design looks this…
Read the full README ↗ · Preview checked 2026-11-16T18:49:58.530Z
Inside the original README — Document outline
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
A Markdown convention and linter for project docs written by AI and read by humans and agents
Repository facts
- Owner
- scarletkc
- Primary language
- Rust
- Stars
- 171
- Forks
- 10
- Open issues + pull requests
- 21
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-09-27T13:27:28.000Z
- Last push
- 2026-10-01T09:29:05.000Z
Topics and intended use
Owner-supplied topics: ai, ai-agents, claude-code, cli, coding-agents, commonmark, conventions, developer-tools, docs-as-code, documentation, documentation-tool, gfm, lint, linter, llm, markdown, markdown-linter, rust, static-analysis, technical-writing
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-03T12:05:37.640Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.