Knowledge
Knowledge guides how the work is done: the decisions already taken, the questions still open, the shared language, the standards and the contracts or designs. Coding agents receive it with every piece of work.
For: Product owner, Project lead
Types
| Type | Use it for | States |
|---|---|---|
| Decision (ADR) | A choice with its context, options and consequences. Accepted decisions bind the records and work they govern. | Proposed → Accepted / Rejected → Superseded |
| Question | Something missing or ambiguous, with the working assumption until a person answers. | Open → Answered |
| Glossary term | A term of the shared language, its definition, synonyms and words to avoid. | Draft → Active → Retired |
| Standard | A rule for how work is done: coding, security, testing, compliance (BDDK, KVKK), Definition of Ready or Done. Must or should. | Draft → Active → Retired |
| Reference | A link to an API contract, event schema, data dictionary, design or document that specifies records or work. | Active → Retired |
| Lesson | Something learned the hard way in this project and what to do instead. Accepted lessons are given to agents; a lesson can be promoted to a project agent rule. | Proposed → Accepted / Rejected → Retired |
| Improvement idea | A way to cut development cost, speed up delivery or improve performance or quality. It can become an epic, story or task. | Proposed → Accepted / Rejected → Retired |
Retrospectives with agents
- About once a day per project and person, after real work, Corpole asks the agent what it learned and what could be done cheaper, faster or better. Its answers arrive here as proposed lessons and ideas marked AI.
- In Claude Code, /corpole:retro runs a retrospective on demand and can bring in lessons from the agent's own memory files (you see the list first; secrets are masked).
- Workspace owners and admins can Share with the whole workspace an accepted lesson: every project then gives it to its agents, with the project it came from. Accept or reject each one. On an accepted lesson, Promote to project rule turns it into an agent rule (needs the Integrations permission); on an idea, Create work item makes an epic, story or task linked to it.
Tenant-wide knowledge and exceptions
Owners and admins can make standards and glossary terms tenant-wide: every project inherits them. A project that needs an exception records a decision that waives the standard; the waiver takes effect when the decision is accepted, and the standard is then left out of that project's context.
What agents do with it
- Read the standards (get_standards) and follow the MUST ones.
- Treat accepted decisions as binding; proposed ones are not.
- Stop and ask when an open question concerns their work; raise new questions with ask_question instead of guessing, and propose choices with propose_decision.
- Use glossary terms exactly; they are matched in the text of the work automatically.