# Simba Codex Lifecycle

> Enforce Simba's Codex lifecycle routine for coding tasks. Use when starting or finishing implementation work in a Simba-enabled repo to run `simba codex-status` at start, `simba codex-extract` when extraction is pending, and `simba codex-finalize` before final handoff. Use when this capability is needed.

- Skill: `tomevault-io/simba-codex-lifecycle` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/simba-codex-lifecycle`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/simba-codex-lifecycle/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/simba-codex-lifecycle

---


# Simba Codex Lifecycle

Run this routine for implementation tasks in Simba-enabled repositories.

## Required Sequence

1. Recall relevant memory first (use the user request as query text):

```bash
simba codex-recall "<user request>"
```

2. Run status once per session:

```bash
simba codex-status
```

Do not run this on every prompt. Re-run only if:
- there was a long pause or major context shift,
- memory actions fail unexpectedly,
- you are about to finalize and want a fresh check.

3. If status reports `pending_extraction`, run:

```bash
simba codex-extract
```

4. Before final handoff, run finalize:

```bash
simba codex-finalize
```

## Finalize Inputs

Prefer to include both response text and transcript path when available:

```bash
simba codex-finalize --response-file /path/to/response.txt --transcript /path/to/transcript.jsonl
```

If those files are not available, still run `simba codex-finalize` as a best-effort check.

If `simba` is not in PATH, use:

```bash
uvx --from /Users/mahmoud/src/ai/simba simba codex-status
```

## Output Discipline

- Mention whether `codex-recall` returned relevant memories and how they informed your approach.
- Mention in your final update that lifecycle checks were run.
- If `codex-status` reports pending extraction, do not ignore it. Run `codex-extract` and report that action.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/mahmoudimus) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->