PHPackages                             jbboehr/doctrine-of-the-second-sun - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. jbboehr/doctrine-of-the-second-sun

ActiveLibrary

jbboehr/doctrine-of-the-second-sun
==================================

Portable doctrine, visual, coding, and software-stewardship guides

031↑2706.5%Nix

Since Aug 8Pushed todayCompare

[ Source](https://github.com/jbboehr/doctrine-of-the-second-sun)[ Packagist](https://packagist.org/packages/jbboehr/doctrine-of-the-second-sun)[ RSS](/packages/jbboehr-doctrine-of-the-second-sun/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

[![Doctrine of the Second Sun](assets/banner.png)](assets/banner.png)

Doctrine of the Second Sun
==========================

[](#doctrine-of-the-second-sun)

Doctrine of the Second Sun is a portable collection of literary, visual, coding, and software-stewardship guidance. It defines one fictional scripture with four canonical books while keeping repository-specific placement and enforcement rules in the projects that consume it.

Documents
---------

[](#documents)

- [`DOCTRINE-STYLE-GUIDE.md`](DOCTRINE-STYLE-GUIDE.md): literary worldview, books, movements, cadence, imagery, and examples.
- [`DOCTRINE-CODING-GUIDE.md`](DOCTRINE-CODING-GUIDE.md): safe insertion and review of literary marginalia in source code.
- [`DOCTRINE-IMAGE-GUIDE.md`](DOCTRINE-IMAGE-GUIDE.md): visual interpretation of completed logia.
- [`DOCTRINE-GENERATION-GUIDE.md`](DOCTRINE-GENERATION-GUIDE.md): tool-neutral writer, reviewer, and insertion workflow.
- [`DOCTRINE-GOLD-EXEMPLARS.md`](DOCTRINE-GOLD-EXEMPLARS.md): exceptional reference logia establishing the quality ceiling for generation and review.
- [`INTEGRATION-GUIDE.md`](INTEGRATION-GUIDE.md): adopting the portable guides in a consuming repository for humans and coding agents.
- [`RUINENWERT.md`](RUINENWERT.md): designing software so its useful knowledge survives active maintenance.
- [`CODE_OF_SOVEREIGNTY.md`](CODE_OF_SOVEREIGNTY.md): repository governance and the sovereignty of forks.

Ruinenwert and the Code of Sovereignty are institutional documents, not books or teachings within the fictional canon.

Composer
--------

[](#composer)

Install the documents as a development dependency:

```
composer require --dev jbboehr/doctrine-of-the-second-sun:dev-master
```

The package root is then available at:

```
vendor/jbboehr/doctrine-of-the-second-sun/

```

Consuming projects should keep their own `AGENTS.md` or equivalent policy for source scope, tag syntax, citation allocation, asset locations, and verification commands. See the [integration guide](INTEGRATION-GUIDE.md) for the full adoption workflow and a local-policy template.

Nix
---

[](#nix)

Add the repository as a flake input:

```
inputs.doctrine-of-the-second-sun.url = "github:jbboehr/doctrine-of-the-second-sun";
```

The default package installs the documents beneath:

```
share/doctrine-of-the-second-sun/

```

A consuming development shell can expose that location explicitly:

```
DOCTRINE_OF_SECOND_SUN_DIR =
  "${inputs.doctrine-of-the-second-sun.packages.${system}.default}/share/doctrine-of-the-second-sun";
```

Prefer one installation mechanism per consuming repository so Composer and Nix locks cannot silently select different revisions.

Codex Integration
-----------------

[](#codex-integration)

Codex-specific writer and reviewer adapters live under [`integrations/codex/`](integrations/codex/README.md). They are optional workflow aids rather than part of the tool-neutral doctrine.

License
-------

[](#license)

Unless otherwise indicated, the documentation, Codex integrations, packaging files, and artwork in this repository are licensed under the [Creative Commons Attribution-ShareAlike 4.0 International License](LICENSE.md).

When attribution is required, a reasonable form is:

> Doctrine of the Second Sun, John Boehr and contributors,

The SPDX identifier is `CC-BY-SA-4.0`. Adaptations must identify their changes and be distributed under the same or a compatible license as required by CC BY-SA 4.0.

###  Health Score

23

—

LowBetter than 25% of packages

Maintenance65

Regular maintenance activity

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/ccc4aa01c69052830471c5ba84c4af824796d46d9920dc8574cb6e368281ab79?d=identicon)[jbboehr](/maintainers/jbboehr)

---

Top Contributors

[![jbboehr](https://avatars.githubusercontent.com/u/225601?v=4)](https://github.com/jbboehr "jbboehr (9 commits)")

### Embed Badge

![Health badge](/badges/jbboehr-doctrine-of-the-second-sun/health.svg)

```
[![Health](https://phpackages.com/badges/jbboehr-doctrine-of-the-second-sun/health.svg)](https://phpackages.com/packages/jbboehr-doctrine-of-the-second-sun)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
