feat: people live on their organization's page until promoted; organization subtype, member-of, broken_anchors lint (#172)
CI / verify (push) Successful in 5m26s
CI / pwsh (push) Successful in 2m8s
Release / release (push) Successful in 34s

Files changed:
- CHANGES.md
- README.md
- VERSION
- instructions/kb-profiles.md
- instructions/link-taxonomy.md
- instructions/page-lifecycle.md
- instructions/wiki-ingest/SKILL.md
- instructions/wiki-lint/SKILL.md
- kb/entities/COLLECTION.md
- kb/entities/INDEX.md
- kb/entities/organizations/E3DC GmbH.md
- kb/entities/people/E3DC GmbH.md
- kb/index.md
- kb/log.md
- tools/CONTRACT.md
- tools/chemenu/commands/lint.py
- tools/chemenu/kb_scan.py
- tools/chemenu/lint_core.py
- tools/chemenu/tests/test_lint.py
- tools/chemenu/tests/test_new_page.py
- tools/chemenu/tests/test_type_resolver.py
- tools/chemenu/tests/test_types_cmd.py
- types/entity.md
- types/entity.organization.md
- types/entity.person.md
- types/entity.schema.yaml

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-04 10:51:46 +02:00
1 parent f3ccbd86f9
commit 4ec22d376d
25 files changed
+368 -30

No files matched your search

+42 -2
View File
@@ -1,7 +1,7 @@
---
profile: entities
outbound:
entities: [depends-on, required-by, runs-on, hosts, uses, produces, consumes, maintains, owns, owned-by, authored, involves, alternative-to, implements, part-of, composition, supersedes, derived-from, adapted-from, see-also]
entities: [depends-on, required-by, runs-on, hosts, uses, produces, consumes, maintains, owns, owned-by, authored, involves, member-of, alternative-to, implements, part-of, composition, supersedes, derived-from, adapted-from, see-also]
concepts: [implements, exemplifies, rests-on, applies-when, operates-on, invokes, authored, alternative-to, see-also]
sources: [evidenced-by, defined-in, see-also]
comparisons: [compares-with, see-also]
@@ -23,6 +23,17 @@ provenance, citation, the confidence machinery - and
[kb/CONVENTIONS.md](../CONVENTIONS.md) for what this instance decided: language, naming forms,
tone, relationship labels, the confidence rubric. Neither is restated here.
<!-- wikitool:toc -->
## Contents
- [Types offered](#types-offered)
- [Per-area emphasis](#per-area-emphasis)
- [People live on their organization's page until they earn their own](#people-live-on-their-organizations-page-until-they-earn-their-own)
- [Authorised labels](#authorised-labels)
- [Outbound linking](#outbound-linking)
- [What does not belong here](#what-does-not-belong-here)
<!-- /wikitool:toc -->
## Types offered
`entity` (`tools/wikitool types describe entity`). The `entity_type:` field selects the area:
@@ -33,7 +44,8 @@ tone, relationship labels, the confidence rubric. Neither is restated here.
| `systems/` | Deployed and running systems, given a descriptive name |
| `tools/` | CLI and desktop tools, named as the tool names itself |
| `technologies/` | Protocols, languages, formats, in their standard spelling and capitalization |
| `people/` | People and organizations, by full name or common handle |
| `people/` | People, by full name or common handle |
| `organizations/` | Companies, public bodies, associations and their departments, by the name they use themselves |
These are areas, not collections: they inherit this contract and carry no `COLLECTION.md`.
@@ -48,6 +60,29 @@ These are areas, not collections: they inherit this contract and carry no `COLLE
- **Tools** - purpose, installation, usage, notable options, which projects use it.
- **People** - role, affiliation, and the projects or decisions they are connected to. Nothing
personal beyond what the source states.
- **Organizations** - what kind of body it is, what it stands to this wiki as (client, supplier,
vendor), and the people in it - see below.
## People live on their organization's page until they earn their own
A person whose source material is a name, a role and a field of work does not get a page: that
page would restate its own title, which is worse than the mention it came from (`wiki-ingest`
step 7). They get a `###` section under the `## Personen` heading of their organization's page
instead - role, field of work, one to three lines. The organization page is then the grouping a
directory level cannot be, and it sits inside the size a page should have rather than a dozen
stubs below it.
A person **is promoted** to a page of their own once a source carries material for one. Their
section shrinks to one line with a `[[wikilink]]`, their page carries `member-of` to the
organization, and every edge and anchor link that meant them moves to the new page. The steps are
[instructions/page-lifecycle.md](../../instructions/page-lifecycle.md) § "Promote a section to its
own page"; `wikitool lint` reports an anchor link left pointing at the vanished section as
`broken_anchors`.
Until then, a person is reached through their organization: a project page's edge points at the
organization (`consults: Kunde X`), and the prose names the person as `[[Kunde X#Anna Müller]]`.
An organization that outgrows its page - by `Split Threshold`, roughly 120-150 lines - splits off
a department or site as an organization page of its own, linked `part-of` the parent.
## Authorised labels
@@ -73,6 +108,11 @@ for the thing nor keeps it running; take `maintains` or `owns` from the person's
those is true instead. `owned-by` is `owns` read from the thing's side - write whichever page a
reader would ask the question on, not both by reflex.
`member-of` runs from a person page to the organization they belong to, and only from a person
who has been promoted to a page (see above) - everyone else is a section on that organization's
page already. It is not `part-of`: a department is a component of its company, a person is not,
and `part-of` stays for the department or site split off an organization that outgrew its page.
Adding a label here is a deliberate contract change, not a way around a refusal.
## Outbound linking