Skip to content

v1.3.0: AGENTS.md, ten new agents, deeper detection

Choose a tag to compare

View all tags
@strifero strifero released this 24 Apr 18:07
· 4 commits to main since this release
v1.3.0
eb4f083

Thirty-three commits on the release branch, one big direction change: ContextEngine now speaks the agents.md standard and actually reads your codebase deeply enough to say something specific about it.

Highlights

AGENTS.md as a first-class target

The cross-tool standard backed by OpenAI, Google, Cursor, Sourcegraph, and Factory (and now stewarded through the Linux Foundation's Agentic AI Foundation) is no longer an afterthought. --tool agents emits an AGENTS.md at the project root, and --tool all includes it. Codex CLI now correctly maps to AGENTS.md (the previous mapping pointed at .claude/skills/, which Codex does not read).

Nine new agent targets

Single source-of-truth body, ten total output surfaces:

Agent Output path
AGENTS.md AGENTS.md
Windsurf .windsurfrules
Aider CONVENTIONS.md
Gemini CLI GEMINI.md
Cline .clinerules
Roo Code .roo/rules.md
JetBrains Junie .junie/guidelines.md
Amazon Q .amazonq/rules/project.md
OpenCode .opencode/AGENTS.md
Zed .rules

Deeper deterministic detection

No LLM, no network. Just a sharper look at your project files:

  • ## Commands extracted from package.json.scripts with correct package-manager prefix (npm run, pnpm, yarn, bun run, bundle exec, composer, dart)
  • Next.js App Router vs Pages Router split based on whether app/ or pages/ exists
  • TypeScript strict and noUncheckedIndexedAccess surfaced in the TypeScript skill; extends chain is now resolved so the check is correct for Next.js projects that extend next/tsconfig.json and for projects using @tsconfig/* shared configs
  • Monorepo detection: Turbo, Nx, pnpm-workspaces, Lerna, Rush
  • Test frameworks: Vitest, Jest, Playwright, Cypress (each with its own skill)
  • Linters and formatters: ESLint flat + legacy, Biome, Prettier

Ten new stack detectors

Astro, SvelteKit, Remix, Nuxt, NestJS, FastAPI, Rails, Laravel, Flutter, Angular. Each ships with its own skill. PackageManager was widened to cover bundler, composer, pub so non-Node ecosystems render correct commands. FastAPI surfaces the detected Python tool (Poetry, uv, or pip).

Windows fix (critical)

--update was overwriting user edits to .claude/skills/*/SKILL.md on Windows because of a path-separator mismatch. Now fixed, with windows-latest added to the CI matrix.

Snapshot test harness

First automated test coverage: 21 fixture projects × 14 tool values = 294 snapshot files, run on Ubuntu and Windows across Node 18 and 20.

README truth-up

The Before / After example now shows actual generator output. Added a "Reads AGENTS.md?" column and a "Why auto-generate?" section answering the common critique. Detected Stacks list reflects what actually ships.

Install

npx @strifero/contextengine@latest

Or globally:

npm install -g @strifero/contextengine

Breaking changes

None. --tool claude default behavior is preserved. The new targets are opt-in via --tool <name> or bundled into --tool all.

Full changelog

v1.2.1...v1.3.0

Merged PRs:

  • #1: feat: AGENTS.md support, deeper detection, broader agent coverage (1.3.0)
  • #2: fix: audit bundle (Windows --update, CI matrix, typo, README em dashes, skill double-colons)
Assets 2
Loading