Greats Soul Archive Contributor
Repo
What to do (happy path)
Pick a destination:
- Real person →
people/<slug>/ - Fiction public domain →
fiction/public-domain/<slug>/ - Fiction inspired-by →
fiction/inspired/<slug>/
- Real person →
Scaffold the folder + files using the script:
python3 scripts/scaffold_profile.py \
--repo ~/tmp/greats-soul-archive \
--kind people \
--slug grace-hopper \
--name "Grace Hopper" \
--category computing \
--tags assistant
Kinds:
peoplefiction-public-domainfiction-inspired
Edit the generated files:
IDENTITY.mdshould be short.SOUL.mdshould be actionable (principles, comms style, failure modes).sources.mdmust be real references; keep uncertainty explicit.
Update the README index:
cd <repo>
python3 scripts/build_index.py
Ensure meta is valid:
- People meta:
people/_meta.schema.md - Fiction meta:
fiction/_meta.schema.md
- People meta:
Open a PR.
Safety / quality rules (must follow)
- Don’t present speculation as fact.
- Avoid defamation/harassment.
- Living people: be extra conservative; prefer direct sources.
- Fiction inspired-by: do not paste long quotes; do not try to reproduce verbatim dialogue/catchphrases.
When you need to look things up
- Repo rules:
CONTRIBUTING.md - Fiction rules:
fiction/_guide.md