SF ShipGlows
Menu Open navigation menu Close navigation menu

ShipGlows Blog

Why ShipGlows should be fed with project pitches

ShipGlows understands your project corpus better when each project has a short pitch that is easy to update.

2026-07-08 5 min governance / projects / pitches / workflow

If you want ShipGlows to understand your project corpus, the first step is to give it something readable. The best starting point is a short project pitch tied to a source of truth.

The goal is not to write long marketing copy. The goal is to give ShipGlows a simple reference card it can use to answer four questions quickly:

  • what is this project
  • who is it for
  • what angle describes it best
  • where does the source of truth live

Why this helps

When each project has a stable pitch, ShipGlows can:

  • recognize the right project faster
  • avoid mixing up similar projects
  • route a source into the right corpus
  • keep useful memory instead of a pile of vague notes

Without a clear pitch, ShipGlows has to guess. With a clear pitch, it can reason.

What a good pitch includes

A good project pitch fits into a few elements:

  1. project name
  2. reference URL
  3. audience
  4. business angle
  5. internal framing note
  6. status

That format is intentionally short. It carries enough information without bloating the fiche.

What comes next

Once the project is introduced into ShipGlows, keep the pitch current. That is the job of the follow-up article: refreshing pitches when the project evolves.

In other words:

  1. first, bring the project into the system
  2. then, refresh it when it changes

That order keeps the base clean and avoids treating an old pitch as if it still described the current project.

Read Next

Keep the editorial thread going.

Why ShipGlows should not rush global primitives for profiles and tags

Global primitives look elegant, but they hard-freeze semantics, debugging posture, and runtime obligations earlier than ShipGlows can safely support.

Open article

How to keep your project pitches current for ShipGlows

A short refresh at the right time is enough to keep your project corpus usable for ShipGlows.

Open article

Why ShipGlows keeps public code and private data in separate repositories

ShipGlows separates framework code from durable private operator data so versioning, backups, and privacy boundaries stay coherent.

Open article