Skip to content

CODEX_HANDOFF.md

Latest commit

 

History

History
48 lines (31 loc) · 1.54 KB

CODEX_HANDOFF.md

File metadata and controls

48 lines (31 loc) · 1.54 KB
Raw

Codex Handoff

This file is the quick-start context for opening the repo in Codex.

One-line context

Agent Portability Kit is a Python CLI and Codex skill/plugin skeleton for converting AI-agent assets — skills, agents, rules/context, MCP configs, and package metadata — into Codex, Cline, or neutral portable output.

What to do first

From the repo root:

python -m pip install -e .
python -m compileall -q src tests
python -m unittest discover -s tests -v
apk scan --source .

First Codex prompt

Read AGENTS.md, README.md, NEXT_STEPS.md, ROADMAP.md, and MANIFEST.md. Run the test suite. Do not edit files yet. Explain the architecture and propose the smallest safe implementation plan for the v0.3.0 typed MCP IR.

Second Codex prompt

Implement NEXT_STEPS.md task 1: add a typed PortableMcpServer IR and align the MCP schema. Add focused tests, preserve dry-run and secret-safety defaults, and do not parse or emit MCP configs yet.

Current milestone

v0.2.0 is complete and includes sidecar copying, stronger classification, frontmatter normalization, and safe invocation conversion.

v0.3.0 should focus on:

  1. typed MCP IR and schema
  2. Codex TOML and Cline JSON importers
  3. secret-to-environment normalization
  4. target-native MCP emitters
  5. adapter-based wrappers and safe merge/diff planning

Same-target skill normalization is deferred.

Expected repo behavior

The tool should never silently mutate source files or global config. All conversion should be planned first and written only in generate mode.