@flancer32/skill-teqfw-esm-validator

Human-governed. Agent-built. Agent-ready.

@flancer32/skill-teqfw-esm-validator validates TeqFW-compatible ES modules with deterministic JSON output, profile-aware rules, and an installable Agent Skill. It is a TeqFW-compatible package: created and evolved by coding agents under the architectural direction and final responsibility of Alex Gusev, and designed to help other agents validate TeqFW code consistently.

Why use it

The package gives projects one deterministic validation boundary for:

• native ESM and module-structure conventions;
• dependency declarations and DI constructor contracts;
• JSDoc contracts and namespace-based type maps;
• regular components and runtime configuration modules.

Validation can target one source file or recursively scan a directory. Results are strict JSON, which makes the CLI suitable for local development, automation, and agent workflows.

Install

npm install -g @flancer32/skill-teqfw-esm-validator

The package installs its Agent Skill automatically during postinstall.

Quick start

Validate one module:

teqfw-esm-validator path/to/module.mjs

Validate a directory recursively:

teqfw-esm-validator path/to/package

Select a profile explicitly:

teqfw-esm-validator --profile type-config-runtime path/to/runtime-config.mjs

The available profiles are:

• base — the default profile for general TeqFW-compatible modules;
• type-regular — rules for regular TeqFW components;
• type-config-runtime — rules for runtime configuration components.

The CLI exits with 0 for valid input and 1 for validation or runtime errors. A successful result looks like this:

{
  "valid": true,
  "violations": []
}

Agent Skill

This package is itself the Agent Skill. Its published skill payload is skill/, with skill/SKILL.md as the entry point, skill/references/ for the knowledge base, and skill/examples/ for compact valid and invalid module patterns.

Development

npm install
npm test

Release notes are tracked in CHANGELOG.md.

Agent-Driven Development

TeqFW is built through the same development model that it is designed to enable: one human defines the intent, architecture, constraints, and acceptance criteria; coding agents implement and maintain the products; other agents use those products in different combinations to create applications.

@flancer32/skill-teqfw-esm-validator is a TeqFW-compatible validation package and an Agent Skill for agents working with TeqFW-compatible modules. The package includes its version-matched Agent Skill in skill/. The README provides a human-facing product overview; the skill provides agents with the package concepts, contracts, integration rules, examples, and boundaries.

Mount the skill into a host project:

mkdir -p .agents/skills
ln -s ../../node_modules/@flancer32/skill-teqfw-esm-validator/skill \
  .agents/skills/teqfw-esm-validator

Each TeqFW package is both a practical software component and a working demonstration of human-governed, agent-driven development. This work follows the Agent-Driven Software Management (ADSM) approach: human intent, architectural authority, acceptance, and responsibility remain authoritative; agents act as implementation and reasoning partners.

• Tequila Framework
• Agent-Driven Software Management: A Practical Guide
• Alex Gusev

License

Apache-2.0. See LICENSE.