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.
| Status | Use when | Supporting cue |
|---|---|---|
| Usable project | Documented users can complete the stated core task. | Solid dot |
| Working prototype | A real implementation runs, with known limits. | Half-filled dot |
| Applied research | Evidence or experiments are the primary output. | Diamond |
| Supporting asset | The repository enables another project. | Square |
| Idea / implementation starting | Scope exists; implementation is absent or partial. | Ring |
| Archived | Work 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.
| Project | Narrow category | Example status line | Required limitation |
|---|---|---|---|
| aibox | CLI | Usable project | State supported hosts and providers. |
| processkit | Process layer | Working prototype | State current API/version constraints. |
| ai-market-research | Applied research | Applied research | State dataset date and methodology limits. |
| KubeClaw | Prototype | Idea / implementation starting | State which flows are implemented. |