The problem
Systems, how-tos and glossaries often live in a tool that is easy to edit and difficult to leave. Agents then need a second copy.
What goes in the repository
- Systems
- Processes
- Reference docs
- Glossaries
- Architecture
- How-tos
- Policies
docs/ ├── index.md ├── systems/ ├── how-to/ ├── reference/ └── glossary/
Why an open repository helps
Readable files can serve people, search and agents without a separate export for each.
How Okide helps
Okide is an editor for that documentation, not a container that replaces the files.
Humans and agents, same files
The same documentation can serve people, search systems and agents without requiring a separate knowledge copy for each.
OPEN BY DEFAULT
Keep the repository. Change the tools around it.
If the documentation tool goes away, the documentation should still open. Okide helps you work with the repository without turning it into an Okide-only format.
Related use cases
COMPANIES
Company knowledge
Build institutional memory the organization can keep.
company/principles.md
Explore →
ROLES
Engineering knowledge
Preserve architecture, decisions and technical context.
engineering/architecture/
Explore →
AGENTS
Internal assistants
Ground answers in knowledge your team can fix.
company/faq.md
Explore →