agent_guide 템플릿 기반으로 프로젝트 구조 설정. Gitea(quantlab-agent), Vikunja(project #15) 연동 완료. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.1 KiB
1.1 KiB
Codebase Conventions (CONVENTIONS.md)
Code Style & Scripts
- Shell / Bash: Ensure standard
$?exit evaluation handling withif [ $? -ne 0 ]; then exit 1; fi. - Batch Scripting: Ensure
%errorlevel%mapping withif %errorlevel% neq 0 ( exit /b %errorlevel% ). Useschcp 65001 >nulfor cross-platform UTF-8 emoji support. - Node.js Scripts: Typically wrapped recursively checking properties (
fs.existsSync,fs.readdirSync), enforcing zero-pollution (ignoring flattened dependencies via explicitfs.writeFileSync).
Architectural Patterns
- Zero-Pollution Rule: Never install global node_modules (
-g) or system modifications. Path routing is managed securely using execution strings formatted likepath/to/local/bininstead of relying on$PATH. - Idempotency Rule: The bootstrap processes (
bootstrap.sh,bootstrap.bat) are designed to be run hundreds of times safely, usingif not existchecks before taking any structural action.
Error Handling
- Terminal outputs are robust, mapping explicit phases like
[1/5],[2/5]to terminal stdout. - Execution halts strictly on critical dependency update failures.