Files
Claude-Code-Workflow/.claude/workflows/context-requirements.md
catlog22 d06a3ca12e Add comprehensive workflows for CLI tools usage, coding philosophy, context requirements, file modification, and CodexLens auto hybrid mode
- Introduced a detailed guide for intelligent tools selection strategy, including quick reference, tool specifications, prompt templates, and best practices for CLI execution.
- Established a coding philosophy document outlining core beliefs, simplicity principles, and guidelines for effective coding practices.
- Created context requirements documentation emphasizing the importance of understanding existing patterns and dependencies before implementation.
- Developed a file modification workflow detailing the use of edit_file and write_file MCP tools, along with priority logic for file reading and editing.
- Implemented CodexLens auto hybrid mode, enhancing the CLI with automatic vector embedding generation and default hybrid search mode based on embedding availability.
2025-12-17 09:53:30 +08:00

1.0 KiB

Context Requirements

Before implementation, always:

  • Identify 3+ existing similar patterns
  • Map dependencies and integration points
  • Understand testing framework and coding conventions

Context Gathering

MANDATORY: Use codex_lens (MCP tool) for all code search and analysis.

codex_lens (REQUIRED)

MCP Actions: init, search, search_files (Advanced ops via CLI: codexlens --help)

Initialize:

codex_lens(action="init", path=".")
  • Auto-generates embeddings if fastembed installed
  • Skip with --no-embeddings flag

Search (Auto hybrid mode):

codex_lens(action="search", query="authentication")

Search Files:

codex_lens(action="search_files", query="payment")

read_file (MCP)

  • Read files found by codex_lens
  • Directory traversal with patterns
  • Batch operations
  • Fallback when codex_lens unavailable
  • Small projects (<100 files)

Exa

  • External APIs, libraries, frameworks
  • Recent documentation beyond knowledge cutoff
  • Public implementation examples