Skip to content

Expand repo taxonomy to 9 types and add public repository policy#14

Open
Ethan-Arrowood wants to merge 4 commits into
mainfrom
repo-taxonomy-expansion-and-policy
Open

Expand repo taxonomy to 9 types and add public repository policy#14
Ethan-Arrowood wants to merge 4 commits into
mainfrom
repo-taxonomy-expansion-and-policy

Conversation

@Ethan-Arrowood

Copy link
Copy Markdown
Member

Summary

Iterates the repo taxonomy from the initial 5-type model into a 9-type model, and adds a companion public repository policy document.

Taxonomy (docs/repo-taxonomy.md)

  • Replaces the catch-all core type with five sharper types: product, plugin, application, library, and meta — keeping template, example, guide, and snapshot.
  • Splits by contract: plugin/application/library track Harper closely; product is independently versioned; meta is public-but-not-a-product; snapshot is frozen.
  • Adds a classification decision tree (mermaid) and a per-type section for each, with upgrade & testing guidance.
  • Links Plugin/Application to the Harper component reference docs so it's unambiguous these mean literal Harper components.

Policy (docs/repository-policy.md, new)

The human- and agent-readable reference for managing active, public repos. Baseline commitments:

  • Clear ownership + a standing maintenance commitment
  • Exactly one taxonomy type, declared as a GitHub topic
  • Required meta docs (LICENSE, README)
  • A declared Harper version via dependencies/peerDependencies or engines (semver)
  • Testing/upgrades per the repo's taxonomy type

Plus a Public Archived section (archived ≠ deleted, when to archive, keep-public vs. move-internal, the required archive README note, and when deletion is warranted).

The two docs cross-link each other. Internal/private repos are explicitly out of scope (separate policy to come).

Marked as WIP in the doc itself — automated enforcement tooling is planned; this is the reference until then.

🤖 Generated with Claude Code

Taxonomy: replace the catch-all `core` type with `product`, `plugin`,
`application`, `library`, and `meta`, keeping `template`, `example`,
`guide`, and `snapshot`. Add a classification decision tree, per-type
sections with upgrade/testing guidance, and link Plugin/Application to
the Harper component reference docs.

Policy: add docs/repository-policy.md — the human- and agent-readable
reference for managing active public repos (ownership, taxonomy topic,
required meta docs, declared Harper version, testing/upgrades) plus a
Public Archived section. Cross-link the two docs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Harper Public Repository Taxonomy and introduces a new Harper Public Repository Policy to establish clear maintenance contracts for public repositories. The review feedback identifies a minor grammatical omission, a logical gap in the classification decision tree for repositories that do not contain a config.yaml file, and a broken reference in the policy document pointing to a deleted section of the taxonomy.

Comment thread docs/repository-taxonomy.md Outdated
Comment thread docs/repository-taxonomy.md
Comment thread docs/repository-policy.md Outdated
Ethan-Arrowood and others added 3 commits July 20, 2026 16:25
Match the repository-policy.md naming and update cross-links.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@kriszyp kriszyp left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me. I think one of the more important aspects of this is that it should be a stronger gate to creating new templates, examples, plugins, etc.; if there isn't a commitment to maintenance, than it can't be defined as one of those.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants