scriptoriumadmin/veritas-kanban
1
0
Fork 0
mirror of https://github.com/BradGroux/veritas-kanban.git synced 2026-08-28 02:44:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

docs: add v4.0 governance quick tips to Tips & Tricks

Browse source 
- Add quick reference table for all v4.0 governance features
- Cover policy engine, decision audit, output scoring,
  drift detection, feedback analytics, system health,
  dashboard widgets, and prompt registry
- Remove version number from Workflow Engine header
This commit is contained in:
bradgroux 2026-03-25 21:39:59 -05:00
parent f906644be7
commit c1b4711162
1 changed files with 16 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
docs/TIPS-AND-TRICKS.md
View file

@ -105,7 +105,7 @@ Combine MCP + prompt registry to let Claude act as your PM.
---
## Workflow Engine (v3.0)
## Workflow Engine
- Define pipelines as YAML in `.veritas-kanban/workflows/`.
- Start runs: `POST /api/workflows/:id/runs`.
@ -113,4 +113,19 @@ Combine MCP + prompt registry to let Claude act as your PM.
- Use tool policies to restrict agent permissions per step.
- See [WORKFLOW-GUIDE.md](WORKFLOW-GUIDE.md) for full details.
---
## v4.0 Governance Quick Tips
| Feature | Quick Usage |
| ---------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Policy Engine** | `POST /api/policies` to define guard rules → `POST /api/policies/:id/evaluate` to test before deploying |
| **Decision Audit** | `POST /api/decisions` with confidence + assumptions → `POST /api/decisions/:id/outcome` to record what happened |
| **Output Scoring** | Create profiles with `POST /api/scoring/profiles` → evaluate with `POST /api/scoring/evaluate` |
| **Drift Detection** | Configure baselines via `POST /api/drift` → check status with `GET /api/drift` for early warnings |
| **Feedback Analytics** | `POST /api/feedback` with sentiment tags → `GET /api/feedback/analytics` for trends |
| **System Health Bar** | `GET /api/v1/system/health` — five levels from `stable` to `alert`, auto-refreshes in the header |
| **Dashboard Widgets** | Drag to reposition, resize handles on corners. Layout saves automatically. |
| **Prompt Registry** | `POST /api/prompt-registry/templates` → version with `/versions` → preview with `/preview` |
Know a trick that belongs here? Add it and mirror to the knowledge base so agents learn it too.