> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Project structure improvement prompt

> A safe prompt for improving any repository's structure.

Use this with Arka:

```text theme={null}
Inspect this repository before changing anything. Build a repo graph and identify
the highest-impact structural problems using dependency centrality, tests,
coupling, duplicate logic, and feature boundaries. Propose a small, ordered
refactor plan. Do not change behavior, public APIs, button order, URLs, or
configuration contracts. For each move, show source, destination, import/reference
updates, risks, and a rollback path. Ask for approval before applying moves. After
approval, make surgical edits, run only tests covering edited files after each
step, then run the broader project gate and report the exact files and results.
Preserve modules that are already clear and do not reorganize for aesthetics alone.
```

For a single file move:

```bash theme={null}
arka move_file src/old.py src/new.py
arka move_file src/old.py src/new.py --yes --update-refs
```

Moves preview by default, refuse destination collisions, and only update simple
textual references when explicitly requested.


## Related topics

- [Prompt optimization](/guides/prompt-optimization.md)
- [Local LLM research notes](/guides/local-llm-research.md)
- [Repo map](/guides/repo-map.md)
- [Reverse-engineer a repository](/guides/repo-reverse.md)
- [MCP integration for Cursor and Claude](/guides/mcp.md)