← Reddit

Long project instructions vs file in project knowledge

Reddit · piffopi · July 28, 2026
A user utilizing Claude for document standardization and template work maintains 2400-word project instructions that require frequent iteration as new requirements emerge. The user questioned whether such lengthy instructions are inefficient due to token consumption with each query, having read that instructions should be limited to around 400 characters, and contemplated using project knowledge files with instructional pointers instead. The user sought advice on the most efficient approach to managing detailed project instructions.

Detailed Analysis

A Reddit user's question about optimal project instruction length in Claude's Projects feature highlights a practical tension that many Claude power users encounter: balancing comprehensive guidance against token efficiency. The poster, who uses Claude as a production assistant for document standardization, template creation, and editorial review, has developed a 2,400-word instruction set that has grown organically through iterative refinement. Their concern stems from anecdotal guidance circulating in AI communities suggesting instructions should be trimmed to roughly 400 characters—a recommendation that, if taken literally, would gut most sophisticated custom instructions down to a few sentences.

The underlying technical reality is straightforward: every message sent within a Claude Project does indeed re-process the full project instructions as part of the context window, since Claude has no persistent memory between calls and relies entirely on what's fed into its context each time. This means longer instructions do consume more tokens per interaction, which matters for both cost (on API-based usage) and the practical context budget available for actual conversation and reference materials. However, the 400-character figure the poster references appears to conflate general prompt-engineering advice for single-shot tasks with the very different use case of Projects, which are explicitly designed to hold persistent, detailed context—including system-level instructions and reference files—precisely so users don't have to re-explain formatting rules, tone, or domain-specific requirements in every chat.

The more interesting question the poster raises—whether to keep instructions inline versus offloading them to a file in Project Knowledge with a pointer reference—touches on a real architectural choice with tradeoffs. Storing detailed rules as a project knowledge file rather than in the instructions field doesn't necessarily save tokens, since Claude still needs to retrieve and read that content to apply it, but it can improve organization, versioning, and editability, especially for someone who iterates frequently as new requirements emerge. Instructions embedded directly in the "custom instructions" field are always in scope for every message, while knowledge files may be referenced more selectively or summarized, depending on how Claude's retrieval works within a project—meaning the split isn't purely cosmetic. For a non-coding, document-heavy workflow like the one described, keeping core behavioral rules (tone, formatting conventions, review checklist) in instructions while pushing longer reference material (style guides, templates, examples) into project knowledge files is a reasonable middle path that many practitioners land on.

This kind of question reflects a broader pattern in how everyday users are learning to work with LLM-based tools: the gap between generic prompt-engineering folklore and the specific mechanics of a given product feature. As Anthropic and competitors continue expanding "memory" and context-management features—larger context windows, persistent project knowledge, and more sophisticated retrieval—users are increasingly forced to develop intuitions about what actually gets re-read, summarized, or cached versus what's discarded. The fact that a non-technical user is asking nuanced architecture questions about token economy and context structuring, rather than just prompt wording, signals how mainstream users are becoming more sophisticated about the mechanics underlying these tools, even without any interest in coding or agentic workflows. It also underscores a recurring theme in AI adoption: the best practices for one use case (short, precise prompts for one-off queries) often don't transfer cleanly to another (persistent, evolving instructions for ongoing collaborative work), and platforms like Claude Projects are still relatively new enough that community wisdom hasn't fully caught up with product capability.

Read original article →