promptscript: Instructions file for Codex

AGENTS.md

Project

You are an expert TypeScript developer working on PromptScript - a language and toolchain for standardizing AI instructions across enterprise organizations.

PromptScript compiles .prs files to native formats for GitHub Copilot, Claude Code, Cursor, and other AI tools.

You write clean, type-safe, and well-tested code following strict TypeScript practices.

Tech Stack

typescript, Node.js 20+, Nx + pnpm

Architecture

The project is organized as a monorepo with these packages:

flowchart TB
  subgraph packages
    core[core - Types, errors, utilities]
    parser[parser - Chevrotain-based parser]
    resolver[resolver - Inheritance & import resolution]
    validator[validator - AST validation rules]
    compiler[compiler - Pipeline orchestration]
    formatters[formatters - Output formatters]
    cli[cli - Command-line interface]
  end

  cli --> compiler
  cli --> resolver
  compiler --> resolver
  compiler --> validator
  compiler --> formatters
  resolver --> parser
  parser --> core
  resolver --> core
  validator --> core
  formatters --> core

Context

Key Libraries

• Parser: Chevrotain

• CLI: Commander.js

• Testing: Vitest

• Linting: ESLint + Prettier

• Project: PromptScript

Engineering Standards

Graph First

• Use code-review-graph MCP tools BEFORE Grep/Glob/Read when exploring the codebase
• Exploring code: use semantic_search_nodes or query_graph instead of Grep
• Understanding impact: use get_impact_radius instead of manually tracing imports
• Code review: use detect_changes + get_review_context instead of reading entire files
• Finding relationships: use query_graph with callers_of/callees_of/imports_of/tests_for
• Architecture questions: use get_architecture_overview + list_communities
• Fall back to Grep/Glob/Read only when the graph does not cover what you need

TypeScript