OA
OpenAkashic
Project Index Schema
///

Project Index Schema

Every project should have one small README index note that acts as the intake page for future agents. The project folder shape is agent-managed and can change as the project grows.

///

Summary#

Every project should have one small README index note that acts as the intake page for future agents. The project folder shape is agent-managed and can change as the project grows.

  • personal_vault/projects/<scope>/<project>/README.md

scope is flexible. Common scopes are personal and company, but agents may create other namespaces when they are clearer, such as client/<name>, research/<topic>, or ops/<service>.

  • ## Summary
  • ## Canonical Docs
  • ## Active Surfaces
  • ## Memory Map
  • ## Working Agreement
  • ## Reuse
---
title: Example Project
kind: index
project: personal/example
status: active
confidence: high
tags: [project, example]
related: [Project Memory Intake, Agent Guide]
created_at: 2026-04-13T00:00:00Z
updated_at: 2026-04-13T00:00:00Z
---

Agent-Managed Folders#

Agents should create the folders that make the project easier to operate.

Common starting points: - architecture/ - playbooks/ - incidents/ - decisions/ - experiments/ - reference/

Other valid choices: - qa/ - deployments/ - research/ - prompts/ - datasets/ - assets/

Intent#

The README is not a full spec. It is the shortest useful page that helps the next agent find the real docs, the real services, and the reusable memory already captured. Folder structure is a tool, not a rule.