Skip to main content

CONCEPTS

Constant CONCEPTS 

Source
pub const CONCEPTS: &str = r"
## Namespaces

Memories are organized into namespaces:

| Namespace | Purpose |
|-----------|---------|
| `decisions` | Architectural and design decisions |
| `patterns` | Discovered patterns and conventions |
| `learnings` | Lessons learned from debugging |
| `context` | Important background information |
| `tech-debt` | Technical debt tracking |
| `apis` | API documentation and contracts |
| `config` | Configuration details |
| `security` | Security findings and notes |
| `performance` | Optimization notes |
| `testing` | Test strategies and edge cases |

## Domains

Domains provide scope isolation:

- **Project** (`project`): Scoped to the current repository
- **User** (`user`): Shared across all projects for the current user
- **Organization** (`org`): Shared within an org when enabled

Org scope is optional and controlled by `SUBCOG_ORG_SCOPE_ENABLED`.

## URN Scheme

Memories are addressed via URNs:

```
subcog://{domain}/{namespace}/{id}
```

Examples:
```
subcog://project/decisions/abc123
subcog://user/decisions/def456
```

## Memory Lifecycle

1. **Active**: Default state, fully searchable
2. **Archived**: Less frequently accessed
3. **Superseded**: Replaced by newer memory
4. **Pending**: Awaiting review
5. **Deleted**: Marked for cleanup
6. **Tombstoned**: Removed from search results; retained for cleanup/audit
";
Expand description

Core concepts documentation.