Lupinum OSS handbook

Use one tested path to create, operate, and release Lupinum open-source projects.

Lupinum OSS is the operating handbook for Lupinum open-source work. It records the rules that must remain consistent across repositories. Tested starters put those rules into new projects. A thin Codex skill helps an agent apply and check them.

The system has one purpose: a maintainer must be able to make a change and release it safely without reconstructing the process from memory.

What the system contains

This handbook explains shared policy and external service setup.
Repository starters contain complete starting points for a library, a package monorepo, and a deployed app.
The Codex skill creates and audits repositories by reading this handbook and the target repository's local instructions.

Every generated repository remains self-contained. AGENTS.md records its architecture and invariants. MAINTAINING.md records its daily procedures. The repository does not depend on the skill at runtime.

Use the same maintainer interface

Every applicable repository exposes these commands:

bash

pnpm verify
pnpm docs:build
pnpm audit:all
pnpm release:verify

The internal commands can differ. Their purpose must not differ.

Read by task

Start a repository

Choose a profile and complete the launch checklist.

Release a package

Use the first-release or normal-release procedure.

Fix a failure

Diagnose npm, GitHub Actions, Vercel, or analytics.

Audit a repository

Check the stored files and external controls.

Governing principle

Prefer deletion, then simplification, then replacement, and only then addition. The standard protects important boundaries. It does not require identical source folders when the products have different technical needs.