Learnings
Understand the planned Learnings feature and how it will help future pipelines remember repository-specific knowledge.
What this means
Learnings is a planned Bilbis feature. The current Learnings page and the Learnings tab on pipeline results show a Shipping soon message.
When it ships, Learnings will store repository-specific knowledge that agents can reuse in future pipelines. Examples include coding conventions, patterns, gotchas, CI fixes, and review fixes.
Current status
Learnings is not live yet.
You may see:
- A blurred preview of learning cards.
- A Shipping soon message on the Learnings page.
- A Shipping soon message in the pipeline detail Learnings tab.
- Disabled controls such as repo selection, Add learning, or Show rejected.
Do not rely on Learnings for production behavior until the feature is released.
What Learnings will help with
| Learning type | What it means | Example use |
|---|---|---|
| Convention | A normal way this repository prefers code to be written. | "Use Result objects for recoverable errors." |
| Pattern | A repeated structure or approach in the codebase. | "Place server actions under the route segment they belong to." |
| CI fix | A fix that helped CI pass before. | "Pin this registry mirror before install." |
| Review fix | Feedback from code review that should guide future runs. | "Avoid changing generated files manually." |
| Gotcha | A known trap or environment detail. | "This runtime does not support a Node-only API." |
Where you will see it
Learnings is designed to appear in two places:
| Place | Purpose |
|---|---|
| Learnings page | Review repository-level knowledge and manage active or rejected learnings. |
| Pipeline detail Learnings tab | See knowledge extracted from or connected to a specific pipeline. |
Planned controls
The previewed implementation includes these controls, but they are not active yet:
| Control | Planned use |
|---|---|
| Repo picker | Choose which repository's learnings to review. |
| Add learning | Add a manual learning for a repository. |
| Show rejected | Include inactive or rejected learnings in the list. |
| Edit | Update a learning's category, confidence, or content. |
| Reject | Soft-delete a learning so it no longer guides future runs. |
| Restore | Re-enable a rejected learning. |
| Delete | Permanently remove a learning. |
Confidence and sources
The planned learning model includes:
- Confidence - how strongly Bilbis trusts the learning, from low to high.
- Source - where the learning came from, such as manual entry, pipeline completion, CI failure, or code reviewer feedback.
- Active state - whether the learning should still guide future runs.
These details are visible in the source model, but the live user workflow is still pending release.
Problems and fixes
| Problem | What to check |
|---|---|
| The Learnings page says Shipping soon | This is expected. The feature is not live yet. |
| The pipeline Learnings tab does not show real data | Per-pipeline learning extraction is planned for a later release. |
| The repo picker is disabled | Learnings management is not enabled in the current UI. |
| You need agents to follow a repo convention today | Put the convention directly in the pipeline task, repository setup notes, or product guidance until Learnings ships. |