question — Claude Code command: what it does, how to install
A Claude Code command that answers questions about a project's layout and docs without touching any files. Use it to get your bearings in a repo.
no license ★ 3,990 updated 2026-03-04
.claude/commands/question.mdWhat question does
/question takes your question as its argument, lists the repo with git ls-files, and reads README.md. Answers come from the file layout and the docs, not from running anything.
It is read-only by design. The frontmatter allows just Bash(git ls-files:*) and Read, and the prompt tells the model not to create or edit files. When a question implies a code change, you get a conceptual description of that change instead.
Replies follow a fixed shape: a direct answer, evidence from the file tree, pointers to the relevant docs. The repo has to be under git, because the file list comes from git ls-files.
What it helps with
- find which folder holds a given module
- learn what a project does from its
README.md - get a description of the changes a new feature would need, with no edits made
- get oriented in an unfamiliar repo before the first task
Example prompts for the agent
/question How is this project laid out and what does each folder do?/question What would I have to change to add a new config option? Explain only, no edits./question What is this project for and which docs should I read first?
How to install question
Manually: put the files in place
.claude/commands/question.mdCall it with /question. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/question.mdCall it with /prompts:question. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/question.prompt.mdManually: put the files in place
.gemini/commands/question.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about question
How do I install question in Claude Code?
Put the command file at .claude/commands/question.md, then run /question followed by your question.
What does question do?
It answers questions about a project using the file list from git ls-files and the contents of README.md. It does not create or modify files.
Can question edit my code?
No. Its prompt forbids creating or changing files, and only Bash(git ls-files:*) and Read are allowed. For changes it describes the approach in words.