rara-codebase

Estrelas14

Forks1

Atualizado27 de julho de 2026 às 04:10

Use when you need to understand the RARA codebase structure — what each file does, where subsystems live, and how they connect. The index maps every source file to its role.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

linkerdog

linkerdog/rara

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

4 arquivos

SKILL.md

readonly

name	rara-codebase
description	Use when you need to understand the RARA codebase structure — what each file does, where subsystems live, and how they connect. The index maps every source file to its role.

RARA Codebase Map

One-line index of every source file, grouped by subsystem.

Memory Subsystem

File	Lines	Role
`memory_store.rs`	15 (facade)	Facade including `memory_types`, `memory_store_impl`, `memory_records`, `memory_store_helpers`
`memory_types.rs`	211	Enums + structs: `MemoryLabel`, `MemorySource`, `MemoryRecord`, `NewMemoryRecord`, `MemoryRecordPatch`, `MemoryRecordSearchHit`
`memory_store_impl.rs`	268	`MemoryStore` struct + CRUD: `insert`, `search`, `get`, `update`, `delete`, `set_pinned`, `list_recent`
`memory_records.rs`	185	`PersistedMemoryRecordFile` + `MemoryRecordFileStore`: file-based persistence with atomic writes
`memory_store_helpers.rs`	372	Utilities: `clamp`, `truncate_string`, `sort_memory_records`, `default_record_path_for_vdb_uri`, `MemoryMetadata`
`memory_store_tests.rs`	587	17 integration tests for insert/read/update/delete/search cycles
`memory_distiller.rs`	315	LLM-powered memory distillation: `distill_thread_markdown()`, `dedupe_memory_drafts()`, `new_memory_record_from_draft()`
`memory_files.rs`	9 (shim)	Re-export from `rara-memory` crate — see `crates/rara-memory/src/files.rs`
`memory_notice.rs`	12	`memory_notice()` formatter for in-context memory action messages
`crates/rara-memory/src/files.rs`	415	File-based memory operations: `write_memory()`, `read_summary_for_context()`, `update_summary()`, `search_memory()`, atomic writes + fs2 locks
`crates/rara-memory/src/vectordb.rs`	619	LanceDB vector database layer: `VectorDB`, `MemoryMetadata`, schema management

Context Subsystem

File	Lines	Role
`context/assembler.rs`	112	`ContextAssembler`: builds effective prompt with memory + hooks injection
`context/memory_selection.rs`	452	Workspace memory selection: `available_memory_sources`, `retrieval_candidates`, scoring
`context/memory_selection_tests.rs`	704	13 tests for memory selection logic
`context/retrieval_provider.rs`	—	Retrieval pipeline: `RetrievalRequest`, `RetrievedMemoryCandidate`
`context/retrieval_view.rs`	—	Memory retrieval display rendering
`context/retrieved_memory_render.rs`	—	TUI rendering for retrieved memory cards
`context/compaction_view.rs`	—	Compaction progress rendering
`context/file_search_provider.rs`	—	File search integration for context
`context/mod.rs`	—	Module exports

Hook Subsystem

File	Lines	Role
`hook_runtime.rs`	321	`HookRuntime`: event-bus subscriber, command hook executor, lifecycle dispatch
`hook_registry.rs`	83	Control-plane hook declarations: `HookRegistry`, `handle_control()`
`hooks.rs`	275	File-system hook discovery: `.claude/hooks/*.md` parsing, `discover_repo_hooks()`

Runtime Subsystem

File	Lines	Role
`runtime_context.rs`	700	Builds `RuntimeBootstrap`: prompt config, tool manager, hook registry, embedding backend, event bus
`runtime_control.rs`	—	`RuntimeControlEvent`, `HookLifecycle`, `HookEvent`

Agent Subsystem

File	Lines	Role
`agent.rs`	1339	Main agent loop, tool calling, streaming
`agent/compact/`	—	Context compaction pipeline
`agent/context_view.rs`	—	Agent context snapshot
`agent/control_handler.rs`	—	Control-plane event handling
`agent/memory_retrieval.rs`	—	Memory retrieval during agent turns
`agent/planning.rs`	—	Agent planning sub-loop
`agent/prompting.rs`	—	Prompt assembly for agent calls

LLM Subsystem

File	Lines	Role
`llm.rs`	—	`LlmBackend` trait + provider dispatch
`llm/types.rs`	—	Request/response types
`llm/shared.rs`	—	Shared provider utilities
`llm/openai_compatible/`	—	OpenAI-compatible provider
`llm/gemini.rs`	—	Gemini provider
`llm/bedrock.rs`	—	AWS Bedrock provider
`llm/ollama.rs`	—	Ollama provider

Tools

File	Lines	Role
`tools/bash.rs`	2315	Bash tool: execution, sandboxing, permission
`tools/agent.rs`	1701	Agent delegation tool
`tools/pty.rs`	1649	PTY terminal tool
`tools/`	—	Additional tools

TUI

File	Lines	Role
`tui/state/types.rs`	—	`TuiApp`, `TranscriptEntry`, `RuntimePhase`, all state types
`tui/state/transcript.rs`	—	Transcript management: `push_entry`, `push_system`
`tui/render/cells/`	—	Cell renderers: active turn, committed turn, responding, message
`tui/runtime/events.rs`	—	`TuiEvent` dispatch
`tui/runtime/tasks.rs`	—	Async task completions: rebuild, compact, OAuth, models

Crates

Crate	Role
`rara-apply-patch`	Pure structured patch parser and text update engine
`rara-memory`	Memory file operations + LanceDB vector database
`rara-persistence`	Persistent state DB (JSON)
`instructions`	Workspace memory + project instructions
`config`	Configuration types

Mais deste repositório

mesmo repositório

release-rara

linkerdog/rara

Use when preparing, validating, tagging, or troubleshooting a RARA release. Enforces the release order that prevents tag versions from diverging from the Cargo package version.

2026-07-0614

handle-unused-code

linkerdog/rara

Handle unused code warnings by investigating purpose via journals, then choose the right fix: suppress, wire-up, or remove.

2026-06-1114

add-tests

linkerdog/rara

Add or update tests for the RARA codebase. Use when implementing non-trivial behavior changes, fixing regressions, tightening TUI rendering, or adding repo-specific test coverage in Rust. Especially relevant for focused unit tests, TUI snapshot tests, agent/runtime regressions, and behavior-driven test updates in this repository.

2026-05-1214

project-github-titles

linkerdog/rara

Use when preparing commit messages, pull request titles, or first-line summaries for the RARA repository. Enforces the repo's short conventional title subset using feat, fix, chore, or test.

2026-05-1214

rara-docs-journal

linkerdog/rara

Use when creating, updating, or reviewing RARA implementation journals under docs/journal/. Applies to dated rollout notes, implementation checkpoints, validation evidence, and deciding what belongs in a journal versus a feature spec or docs/todo.md.

2026-05-1214

rara-docs-spec

linkerdog/rara

Use when creating, revising, or reviewing RARA canonical feature specs under docs/features/. Applies to stable runtime, TUI, protocol, memory, provider, skill, plugin, and tool contracts, including scope boundaries and validation matrices.

2026-05-1214

name	rara-codebase
description	Use when you need to understand the RARA codebase structure — what each file does, where subsystems live, and how they connect. The index maps every source file to its role.

RARA Codebase Map

One-line index of every source file, grouped by subsystem.

Memory Subsystem

File	Lines	Role
`memory_store.rs`	15 (facade)	Facade including `memory_types`, `memory_store_impl`, `memory_records`, `memory_store_helpers`
`memory_types.rs`	211	Enums + structs: `MemoryLabel`, `MemorySource`, `MemoryRecord`, `NewMemoryRecord`, `MemoryRecordPatch`, `MemoryRecordSearchHit`
`memory_store_impl.rs`	268	`MemoryStore` struct + CRUD: `insert`, `search`, `get`, `update`, `delete`, `set_pinned`, `list_recent`
`memory_records.rs`	185	`PersistedMemoryRecordFile` + `MemoryRecordFileStore`: file-based persistence with atomic writes
`memory_store_helpers.rs`	372	Utilities: `clamp`, `truncate_string`, `sort_memory_records`, `default_record_path_for_vdb_uri`, `MemoryMetadata`
`memory_store_tests.rs`	587	17 integration tests for insert/read/update/delete/search cycles
`memory_distiller.rs`	315	LLM-powered memory distillation: `distill_thread_markdown()`, `dedupe_memory_drafts()`, `new_memory_record_from_draft()`
`memory_files.rs`	9 (shim)	Re-export from `rara-memory` crate — see `crates/rara-memory/src/files.rs`
`memory_notice.rs`	12	`memory_notice()` formatter for in-context memory action messages
`crates/rara-memory/src/files.rs`	415	File-based memory operations: `write_memory()`, `read_summary_for_context()`, `update_summary()`, `search_memory()`, atomic writes + fs2 locks
`crates/rara-memory/src/vectordb.rs`	619	LanceDB vector database layer: `VectorDB`, `MemoryMetadata`, schema management

Context Subsystem

File	Lines	Role
`context/assembler.rs`	112	`ContextAssembler`: builds effective prompt with memory + hooks injection
`context/memory_selection.rs`	452	Workspace memory selection: `available_memory_sources`, `retrieval_candidates`, scoring
`context/memory_selection_tests.rs`	704	13 tests for memory selection logic
`context/retrieval_provider.rs`	—	Retrieval pipeline: `RetrievalRequest`, `RetrievedMemoryCandidate`
`context/retrieval_view.rs`	—	Memory retrieval display rendering
`context/retrieved_memory_render.rs`	—	TUI rendering for retrieved memory cards
`context/compaction_view.rs`	—	Compaction progress rendering
`context/file_search_provider.rs`	—	File search integration for context
`context/mod.rs`	—	Module exports

Hook Subsystem

File	Lines	Role
`hook_runtime.rs`	321	`HookRuntime`: event-bus subscriber, command hook executor, lifecycle dispatch
`hook_registry.rs`	83	Control-plane hook declarations: `HookRegistry`, `handle_control()`
`hooks.rs`	275	File-system hook discovery: `.claude/hooks/*.md` parsing, `discover_repo_hooks()`

Runtime Subsystem

File	Lines	Role
`runtime_context.rs`	700	Builds `RuntimeBootstrap`: prompt config, tool manager, hook registry, embedding backend, event bus
`runtime_control.rs`	—	`RuntimeControlEvent`, `HookLifecycle`, `HookEvent`

Agent Subsystem

File	Lines	Role
`agent.rs`	1339	Main agent loop, tool calling, streaming
`agent/compact/`	—	Context compaction pipeline
`agent/context_view.rs`	—	Agent context snapshot
`agent/control_handler.rs`	—	Control-plane event handling
`agent/memory_retrieval.rs`	—	Memory retrieval during agent turns
`agent/planning.rs`	—	Agent planning sub-loop
`agent/prompting.rs`	—	Prompt assembly for agent calls

LLM Subsystem

File	Lines	Role
`llm.rs`	—	`LlmBackend` trait + provider dispatch
`llm/types.rs`	—	Request/response types
`llm/shared.rs`	—	Shared provider utilities
`llm/openai_compatible/`	—	OpenAI-compatible provider
`llm/gemini.rs`	—	Gemini provider
`llm/bedrock.rs`	—	AWS Bedrock provider
`llm/ollama.rs`	—	Ollama provider

Tools

File	Lines	Role
`tools/bash.rs`	2315	Bash tool: execution, sandboxing, permission
`tools/agent.rs`	1701	Agent delegation tool
`tools/pty.rs`	1649	PTY terminal tool
`tools/`	—	Additional tools

TUI

File	Lines	Role
`tui/state/types.rs`	—	`TuiApp`, `TranscriptEntry`, `RuntimePhase`, all state types
`tui/state/transcript.rs`	—	Transcript management: `push_entry`, `push_system`
`tui/render/cells/`	—	Cell renderers: active turn, committed turn, responding, message
`tui/runtime/events.rs`	—	`TuiEvent` dispatch
`tui/runtime/tasks.rs`	—	Async task completions: rebuild, compact, OAuth, models

Crates

Crate	Role
`rara-apply-patch`	Pure structured patch parser and text update engine
`rara-memory`	Memory file operations + LanceDB vector database
`rara-persistence`	Persistent state DB (JSON)
`instructions`	Workspace memory + project instructions
`config`	Configuration types