cortex-setup-project skill
✓ 인증됨새 프로젝트를 위한 Cortex 부트스트랩 또는 기존 세션 기록을 가져와 인지 프로필을 구축하고 코드베이스 메모리를 생성합니다.
- GitHub 스타
- 76
- 파일
- 1
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- MIT
- 허용된 도구
- —
cortex-setup-project skill은 무엇을 하나요?
새 프로젝트를 위한 Cortex 부트스트랩 또는 기존 세션 기록을 가져와 인지 프로필을 구축하고 코드베이스 메모리를 생성합니다.
skill의 SKILL.md에서 생성된 요약입니다.
cortex-setup-project skill 정보
이 SKILL은 새 프로젝트를 위한 인지 프로필 초기화 및 코드베이스 메모리 생성을 지원합니다. 개발자는 처음부터 시작하거나 기존 세션 기록을 가져와 지식 기반을 구축함으로써 Cortex 시스템을 부트스트랩할 수 있습니다. 이 프로세스는 인프라 검증, 프로필 구축, 코드베이스 시딩 단계를 거치며, 수동 명령 실행이나 사용자 결정 없이 완전히 자율적으로 진행됩니다.
사용자가 Cortex 설정, 프로젝트 시딩 또는 메모리 백필을 요청할 때 에이전트는 이 SKILL을 로드해야 합니다. 연결 확인을 위한 cortex:memory_stats 및 도메인 허브 생성을 위한 cortex:rebuild_profiles와 같은 도구에 의존합니다. ai-architect-mcp-codebase 서버를 사용할 수 있는 경우, 코드베이스 구조를 흡수하기 위해 더 깊은 심볼 레벨 분석을 수행할 수 있습니다. 프로세스는 감쇠 및 압축을 통해 메모리를 통합하고 도메인, 엔티티 및 지식 격차에 대한 최종 요약을 제공하며 마무리됩니다.
agent가 수행할 수 있는 작업
- 1새 프로젝트 메모리 부트스트랩도메인 특화 인지 프로필 구축을 시작하기 위해 새로운 코드베이스에 대한 Cortex 환경을 초기화합니다.
- 2이전 대화 기록 가져오기프로젝트 지식의 연속성을 유지하기 위해 최대 500개의 기존 세션 파일을 메모리 스토어에 백필합니다.
- 3심층 코드베이스 분석 수행ai-architect-mcp-codebase 서버를 통합하여 대규모 코드베이스에 대한 심볼 레벨 메모리 및 구조적 분석을 활성화합니다.
- 4메모리 인프라 검증 및 복구SQLite 또는 PostgreSQL 메모리 백엔드의 연결 문제를 자동으로 진단하고 수정합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
cortex-setup-project skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.플러그인에 cortex-setup-project skill 설치
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Claude Code에 cortex-setup-project skill 설치
~/.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-projectClaude Code (project)에 cortex-setup-project skill 설치
.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project .claude/skills/cortex-setup-projectCodex에 cortex-setup-project skill 설치
~/.agents/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.agents/skills/cortex-setup-projectGemini CLI에 cortex-setup-project skill 설치
~/.gemini/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.gemini/skills/cortex-setup-projectClaude.ai에 cortex-setup-project skill 설치
npx degit cdeust/Cortex/skills/cortex-setup-project cortex-setup-project && zip -r cortex-setup-project.zip cortex-setup-project # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cortex-setup-project.zip
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능cdeust/cortex/skills/cortex-setup-project is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-setup-proje ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-12github.com/cdeust/cortex/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 67 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗통과
SKILL.md
GitHub에서 보기Setup Project — Fully Autonomous Bootstrap
Execute all four phases sequentially without asking the user any questions. If a phase fails, attempt automatic recovery before reporting the error. Never ask the user to run commands manually or choose between options.
Phase 1: Infrastructure Verification
- Call
cortex:memory_stats({})to verify store connectivity. If it succeeds, the store is healthy — this covers both backends (the zero-config SQLite default needs no PostgreSQL, so do NOT runpg_isreadyor any PostgreSQL setup when this passes). Proceed to Phase 2. - Only if
memory_statsfails: callcortex:check_setup({})(backend-aware diagnostics) to identify the failure.- SQLite backend reported: fix per the check output (usually
~/.claude/methodologypermissions or a corruptmemory.db); do NOT install PostgreSQL. - PostgreSQL backend reported: run
pg_isreadyvia bash, thenbash "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh"automatically. Do not ask for permission. After setup.sh completes, callcortex:memory_stats({})again to verify. - If it still fails, report the error output and stop. Do not continue to later phases.
- SQLite backend reported: fix per the check output (usually
Phase 2: Build Methodology Profiles
- Call
cortex:rebuild_profiles({"force": true})to scan all session history and build cognitive profiles per domain. - This creates the domain hubs that memories, entities, and discussions link to. It must run before seeding.
- Record the domain count for the final summary.
Phase 3: Codebase Seeding
- Call
cortex:seed_project({"directory": "<cwd>"})where<cwd>is the current working directory. - Record the count of discoveries for the final summary.
Phase 3b: Pipeline Codebase Analysis (Optional)
The ai-architect-mcp-codebase MCP server provides structured codebase analysis (symbol graph, processes, communities, cross-file impact). It is optional — Cortex core memory/recall works without it. Enable only if the user asks for "deeper code understanding", "symbol-level memory", or the codebase is large (>5k files) where substring-based hooks underperform.
- Detection: attempt
cortex:ingest_codebase({"project_path": "<cwd>"}). If it succeeds, record the counts (wiki pages, memory entities, KG edges) for the summary and skip to Phase 4. - If
ingest_codebasefails withMcpConnectionError(pipeline not installed/configured):- Check if the sibling checkout exists at
../anthropic/ai-architect-mcp-codebase/Cargo.toml(or equivalent). If so, runbash -c 'cd ../anthropic/ai-architect-mcp-codebase && cargo install --path . 2>&1 | tail -20'(accepts ~1-2 min compile) and re-run the ingest. - If the source checkout is missing or cargo is unavailable, skip Phase 3b silently and proceed to Phase 4. Do NOT block setup on this.
- Check if the sibling checkout exists at
- The pipeline's auto-wire happens on every SessionStart via
pipeline_discovery, so once the binary exists on PATH (or sibling source is built), future sessions pick it up automatically. No manual mcp-connections.json editing needed.
Phase 4: History Import
- Call
cortex:backfill_memories({"dry_run": true, "max_files": 500})to preview available session files. - If files are available, call
cortex:backfill_memories({"max_files": 500, "min_importance": 0.35})to import. - Record the count of imported memories for the final summary.
Phase 5: Consolidation and Verification
- Call
cortex:consolidate({})to run decay, compression, CLS, and causal discovery on all memories. - Call
cortex:memory_stats({})to get the final system state. - Call
cortex:detect_gaps({})to identify knowledge gaps.
Final Summary
After all phases complete, print a single summary block:
Cortex Setup Complete
---------------------
Domains: <count from rebuild_profiles>
Memories stored: <total from memory_stats>
Entities: <count from memory_stats>
Relationships: <count from memory_stats>
Pipeline: <"active — N wiki pages, M memories" | "skipped (not installed)">
Gaps found: <count and brief description from detect_gaps>
Do not print intermediate status updates between phases beyond what the tool calls themselves return. One summary at the end.
이 스킬의 파일
1cortex-setup-project skill 질문
Claude Code에 cortex-setup-project skill을 어떻게 설치하나요?
npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-project를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
cortex-setup-project skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
설정 중 데이터베이스 연결에 실패하면 어떻게 되나요?
시스템이 백엔드 인지 진단을 실행하여 자동 복구를 시도합니다. SQLite의 경우 권한이나 손상 여부를 확인하며, PostgreSQL의 경우 bash를 통해 설정 스크립트 실행을 시도합니다.
설정 과정에서 코드베이스를 더 깊이 이해할 수 있나요?
네, 요청 시 또는 코드베이스가 큰 경우 심볼 레벨 메모리 및 구조적 분석을 위한 선택적 파이프라인 코드베이스 분석을 활성화할 수 있습니다.
설정 과정에서 사용자의 수동 개입이 필요한가요?
아니요, 설정은 완전히 자율적으로 설계되었습니다. 질문을 던지거나 수동으로 명령을 실행할 필요 없이 모든 단계를 순차적으로 수행합니다.