@wipcomputer/wip-readme-format 1.9.15 → 1.9.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +49 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
###### WIP Computer
|
|
2
|
+
|
|
3
|
+
# README Formatter
|
|
4
|
+
|
|
5
|
+
Generate or validate READMEs that follow the WIP Computer standard. Badges, title, tagline, "Teach Your AI" block, features, interface coverage table, license.
|
|
6
|
+
|
|
7
|
+
## What it does
|
|
8
|
+
|
|
9
|
+
- Generates separate section files (README-init-badges.md, README-init-features.md, etc.) so you can edit any section independently
|
|
10
|
+
- Deploy assembles them into the final README
|
|
11
|
+
- Same pattern as release notes: staging, review, deploy
|
|
12
|
+
- Validates existing READMEs against the standard
|
|
13
|
+
|
|
14
|
+
## Templates
|
|
15
|
+
|
|
16
|
+
All standard content lives in `ai/wip-templates/readme/`. Edit the templates, every tool picks up the changes. No code changes needed.
|
|
17
|
+
|
|
18
|
+
| Template | What it is |
|
|
19
|
+
|----------|-----------|
|
|
20
|
+
| `wip-lic-footer.md` | License section (plain text + markdown formats) |
|
|
21
|
+
| `cla.md` | Contributor License Agreement |
|
|
22
|
+
| `LICENSE.md` | Full dual MIT+AGPLv3 LICENSE file |
|
|
23
|
+
| `prompt.md` | Standard "Teach your AI" install prompt template |
|
|
24
|
+
|
|
25
|
+
Both `wip-readme-format` and `wip-license-guard` read from these templates at runtime.
|
|
26
|
+
|
|
27
|
+
## Usage
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# Generate section files for review
|
|
31
|
+
node tools/wip-readme-format/format.mjs /path/to/repo
|
|
32
|
+
|
|
33
|
+
# Assemble sections into final README
|
|
34
|
+
node tools/wip-readme-format/format.mjs /path/to/repo --deploy
|
|
35
|
+
|
|
36
|
+
# Preview without writing
|
|
37
|
+
node tools/wip-readme-format/format.mjs /path/to/repo --dry-run
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Requirements
|
|
41
|
+
|
|
42
|
+
- node (18+)
|
|
43
|
+
|
|
44
|
+
## Interfaces
|
|
45
|
+
|
|
46
|
+
- **CLI**: Command-line tool
|
|
47
|
+
- **Skill**: SKILL.md for agent instructions
|
|
48
|
+
|
|
49
|
+
## Part of [AI DevOps Toolbox](https://github.com/wipcomputer/wip-ai-devops-toolbox)
|