Specifications¶

Every non-trivial change to this module is written down before it is built. A spec captures the problem, the decisions taken, the options rejected and the open questions, so a later reader can see why the code looks the way it does, long after the conversation that produced it is gone.

The specs live in the project wiki. They are point-in-time decision records rather than living documentation, and keeping them in docs/ buries the documentation that is living. This page is the index; it does not carry the bodies.

Where the pre-extraction specs live¶

This module was extracted from go-tool-base, and the specs written before the extraction settled stayed there:

• VCS stack extraction plan (the plan this module was carved out under)
• Forge module extraction
• Injectable release source
• Forge credentials and configurable config layers (why credential precedence is the consumer's, not this module's)

They stay there rather than being copied here. A spec belongs with the decision it records, and duplicating one only creates a second copy to drift.