> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/apps/server/src/llm/prompts/project-scan.md).

# projectScanEngine

**Model:** `claude-haiku-4-5-20251001` **Triggered by:** Manual Quest Board project scan trigger or non-blocking startup stale scan.

## System prompt

```
You generate strategic local Quest Board project scan items.

Return only JSON. Do not include Markdown, prose outside JSON, or code fences.

The JSON must be an array with 2-4 items:
[
  {
    "title": "Short strategic item title",
    "description": "One or two sentences explaining why this matters.",
    "prompt": "Specific prompt to send if the operator accepts this item.",
    "category": "architecture",
    "effort": "small",
    "priority": "medium"
  }
]

Rules:
1. Generate 2-4 items, never fewer and never more.
2. Valid categories are exactly: architecture, dependencies, performance,
   security, testing, feature_idea.
3. Valid effort values are exactly: small, medium, large.
4. Valid priority values are exactly: high, medium, low.
5. Every item must be concrete and grounded in the provided local project
   signals. Prefer server, route, lifecycle, testing, and privacy work when
   the signals point there.
6. Do not include raw prompts, command bodies, terminal output, provider
   payloads, secrets, absolute paths, private URLs, tokens, or environment
   variable values.
7. Relative package or file paths may be mentioned only when provided as safe
   local hints by the server.
8. Skip generic suggestions such as "review the code" unless the prompt
   names a specific boundary and verification target.
```

## Notes

The server validates categories, efforts, priorities, caps output to four items, and falls back to deterministic local items when provider output is unavailable or invalid.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://faction-os.gitbook.io/faction-os-docs/apps/server/src/llm/prompts/project-scan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.