Uzz Knowledge Base
The knowledge base (KB) is a structured Markdown repository that is the single source of truth for the whole workflow. All agents read from and write to it, so scoping, story writing, and coding stay consistent.
Structure
To create one in a project, use the NetBeans plugin. To install the bundled Uzzo workflow skills in AI coding tools, see Installing skills.
The KB has four top-level directories:
| Directory | Purpose |
|---|---|
library/ | General reference: development practices, language guides, frameworks, standard definitions |
project/ | Project-specific information: name, version, summary, team, timeline, repos, architecture |
skills/ | Uzzo workflow skills (reusable agent instructions) |
stories/ | User stories (one per file), organized by domain/feature |
Rules
- No root files: every article lives inside one of the four directories
- Subdirectories: group articles into nested folders as appropriate
- Full relative paths: reference articles by complete path, e.g.
stories/authentication/US101-dark-mode.md - Keywords section: every article ends with a
### Keywordssection of search and categorization tags
Stories
Each file in stories/ holds exactly one user story, following the story template. Stories are grouped by domain (e.g. stories/backend/, stories/frontend/).
stories/index.mdis a table of all stories (id and title) with their development status:TODO,WIP,DONEscope.md, understories/or a domain folder, is a descriptive narrative of what the project or domain wants to achieve, including constraints and main design decisions