core/skills/core-bootstrap.md
Shay 3cd056b476
Some checks failed
lane-shas / verify pinned lane SHAs (pull_request) Failing after 3s
smoke / smoke (-m "not quarantine") (pull_request) Failing after 54s
docs: remove dangling reference to deprecated docs/dev/git-forgejo.md
core-bootstrap.md linked docs/dev/git-forgejo.md, which was removed as
deprecated (c0cbd13d) — the git+Forgejo setup lives in AGENTS.md. Drop the
dead link. Surfaced by the main-lineage reconciliation audit.
2026-07-11 23:18:31 -07:00

2.2 KiB

name description triggers auto_invoke
core-bootstrap Mandatory statelessness compensation, workspace hygiene, clean-baseline setup, smoke test, and session-break-summary check for CORE. Auto-invoked on session/subagent start.
session_start
new_subagent
arena_spawn
true

Execute the full Session Start Checklist from GROK.md in strict order, including the Workspace Hygiene + Branch/Worktree Protocol.

Important: We use plain git (with insteadOf forwarding to Forgejo) and never gh. See AGENTS.md for the required global config and setup.

  1. Read GROK.md in full.
  2. Read AGENTS.md in full.
  3. Read docs/specs/runtime_contracts.md in full.
  4. Confirm project root:
    • pwd
    • git rev-parse --show-toplevel
    • verify GROK.md and AGENTS.md exist.
  5. Inspect local state before any branch movement:
    • git status --short --branch
    • git diff --stat
    • git diff --name-status
    • git diff --cached --name-status
    • git stash list
    • git worktree list
  6. If dirty, classify every changed or untracked file before switching branches. Unknown work must be preserved with a descriptive stash, not destroyed.
  7. Fetch current repository state:
    • git fetch origin --prune
  8. If starting new work, establish clean current main:
    • git switch main
    • git pull --ff-only origin main
  9. For non-trivial implementation, create a fresh worktree from origin/main unless the user explicitly requests same-worktree work.
  10. Run core test --suite smoke -q and report pass/fail. If unavailable, report the exact failure and use repo-native pytest lanes.
  11. Check for any recent session-break-summary-*.md files (see AGENTS.md Session Continuity section) and read the most relevant one.
  12. Check recent open PRs if local changes or task continuity are ambiguous:
  13. State task scope in one clear sentence before any further action.

This skill must complete successfully before any editing, proposal, or subagent work. It is non-bypassable for Grok 4.3 / Grok Build sessions on CORE.