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

40 lines
2.2 KiB
Markdown

---
name: core-bootstrap
description: Mandatory statelessness compensation, workspace hygiene, clean-baseline setup, smoke test, and session-break-summary check for CORE. Auto-invoked on session/subagent start.
triggers: ["session_start", "new_subagent", "arena_spawn"]
auto_invoke: 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:
- Use the Forgejo web UI: https://core-gitquarters.acbcontent.org/core-labs/core/pulls
- Or `git fetch origin --prune && git branch -r | head -20` for remote branches.
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.