nickCodex-READY

Персональная ОС для работы с Codex, Claude Code и другими coding agents. Это переносимый context pack: один root contract, живая память, reusable skills, runtime-слой и шаблоны для новых repo.

Entry Points

• .\resume.ps1 — печатает готовый prompt для входа в текущий проект
• .\new-project.ps1 <name> — создаёт новый project-local repo рядом с этим pack
• .\new-memory-repo.ps1 <name> — создаёт отдельный git-backed memory repo рядом с этим pack
• .\doctor.ps1 — проверяет tooling, env и минимальный project-local context
• powershell -ExecutionPolicy Bypass -File scripts/smoke-codex-subagents.ps1 — проверяет .codex/ config, custom agents и живой Codex runtime
• powershell -ExecutionPolicy Bypass -File scripts/sync-project-subagents.ps1 — синхронизирует .codex/ subagent layer в соседние project-local repo
• powershell -ExecutionPolicy Bypass -File scripts/sync-agent-skills.ps1 — синхронизирует repo-native wrappers в .agents/skills/ из канонического skills/
• powershell -ExecutionPolicy Bypass -File scripts/sync-profile-from-obsidian.ps1 — обновляет repo snapshot профиля из Obsidian-канона
• .\setup-openclaw-laptop.ps1 — быстрый bootstrap второго ноута под Codex + OpenClaw
• .\finalize-openclaw-laptop.ps1 — добивает OpenClaw после логина вторым Codex-аккаунтом
• powershell -ExecutionPolicy Bypass -File scripts/validate-project-context.ps1 -TargetPath <path> — валидирует project-local scaffold

Subagents

• Project-scoped Codex subagents live in .codex/agents/.
• repo_recon - read-only architecture mapping and first-pass repo understanding
• security_reviewer - read-only security and unsafe-default review
• docs_researcher - official docs, API checks, version-sensitive verification
• exa_researcher - fresh web research, source discovery, current comparisons, implementation examples
• notebooklm_summarizer - source-backed summaries for videos, articles, PDFs, and source bundles
• browser_debugger - browser reproduction, screenshots, console and network evidence
• targeted_fixer - smallest defensible local fix after the failure mode is known
• Global subagent settings live in .codex/config.toml.
• Agent-specific MCP wiring lives in the matching .codex/agents/*.toml file.
• After changing .codex/, run .\doctor.ps1 or scripts/smoke-codex-subagents.ps1.

Skills

• Canonical reusable skills live in skills/.
• Repo-native Codex discovery lives in .agents/skills/.
• .agents/skills/* are generated wrappers, not a second source of truth.
• After changing any skill, run scripts/sync-agent-skills.ps1, then scripts/validate-context-pack.ps1.
• When naming a new skill, avoid generic names that can collide with user or system skills in Codex selectors.
• skills/optional/huashu-design is a lightweight personal-use derivative inspired by alchaincyf/huashu-design, checked at 23f60d9b4304f20851469987c6e2c92242b94a45. Upstream is Personal Use Only; this repo does not vendor upstream assets, scripts, demos, audio, or full skill text.

Profile Snapshot

• Obsidian GameChanger\AI\ is the personal-profile canon.
• aboutme.md, deep-values.md, deep-philosophy.md, and writing-style.md in this repo are portable snapshots for GitHub clone.
• Do not replace these repo files with absolute symlinks; that breaks portability on another machine.
• To refresh the snapshots, run scripts/sync-profile-from-obsidian.ps1, review the diff, then commit intentional changes.

Review

• code_review.md holds the review contract for humans and Codex.
• .github/workflows/codex-review.yml runs PR review through openai/codex-action@v1.
• To enable the workflow, add the repository secret OPENAI_API_KEY.

Quick Start

С нуля на другом компе:

git clone https://github.com/NickStr11/nickCodex-READY.git
cd nickCodex-READY
powershell -ExecutionPolicy Bypass -File scripts/bootstrap-portable.ps1

В новом Codex-чате:

Подними AGENTS.md и CODEX-USAGE.md. Используй $daily-session, проверь текущий фокус и продолжи работу.

Локально, если repo уже есть:

cd D:\path\to\nickCodex-READY

Открой AGENTS.md, для daily работы держи рядом DAILY.md, для живого статуса смотри inbox/now.md и memory/DEV_CONTEXT.md. Для переезда на другой комп используй PORTABILITY.md. Если нужно дать новому Codex готовый чек-лист восстановления, используй RESTORE-CHECKLIST.md. Для отдельной долгой памяти используй MEMORY-REPO-RUNBOOK.md и .\new-memory-repo.ps1 claw-memory. Для редких OpenClaw-сценариев смотри runbooks/openclaw/README.md.

Если менялась структура или документация:

powershell -ExecutionPolicy Bypass -File scripts/sync-agent-skills.ps1
powershell -ExecutionPolicy Bypass -File scripts/validate-context-pack.ps1

Для вклада в сам repo смотри CONTRIBUTING.md.

License

MIT