Status treatments

Text-first maturity labels for truthful portfolio presentation.

Required pattern

Every project presentation must show a status as text. Color, icons, position, and motion may reinforce the label but must never replace it.

StatusUse whenSupporting cue
Usable projectDocumented users can complete the stated core task.Solid dot
Working prototypeA real implementation runs, with known limits.Half-filled dot
Applied researchEvidence or experiments are the primary output.Diamond
Supporting assetThe repository enables another project.Square
Idea / implementation startingScope exists; implementation is absent or partial.Ring
ArchivedWork is preserved but no longer maintained.Horizontal bar

Do not substitute broad claims such as “platform”, “production-ready”, or “enterprise” unless the owning repository publishes evidence for that claim. Prefer narrow artifact categories: CLI, process layer, applied research, prototype, library, or supporting asset.

Accessibility

  • Keep the full status label visible at all viewport sizes.
  • Pair every color with the status-specific shape in the table.
  • Use normal text contrast of at least 4.5:1 and large-text/UI contrast of at least 3:1.
  • Test light and dark variants independently.
  • Do not encode a status change with animation alone.

The source templates use high-contrast neutral text and reserve accent color for a supporting rule. Maintainers must rerun local validation after changing colors.

Project examples

Examples are prompts for maintainers, not permanent factual claims. Confirm each status and limitation with the owning repository before publishing.

ProjectNarrow categoryExample status lineRequired limitation
aiboxCLIUsable projectState supported hosts and providers.
processkitProcess layerWorking prototypeState current API/version constraints.
ai-market-researchApplied researchApplied researchState dataset date and methodology limits.
KubeClawPrototypeIdea / implementation startingState which flows are implemented.