name: z8-development description: Guidelines and instructions for developing the Z8 runtime. Includes coding standards, build processes, and testing workflows. license: Apache-2.0 metadata: author: Zane V8 Authors version: "1.0.0"

Z8 Development Skill

This skill provides instructions for maintaining and extending the Z8 JavaScript runtime.

Coding Standards

All C++ code in the Z8 project should adhere to the following standards:

• Methods: Use camelCase (e.g., readFile, setTimeout).
• Member Variables: Prefix with m_ (e.g., m_count, m_isRunning).
• Pointers: Prefix with p_ (e.g., p_isolate, p_context).
• Static Variables: Prefix with s_ (e.g., s_instance).
• Integer Types: Use int32_t instead of int.
• Reference Docs: Agent MUST read and follow docs/CODING_STYLE_en.md, docs/OPTIMIZATION.md, và docs/TOOLS_GUIDE_vi.md to understand the project deeply.

Build Process

The project is built using a PowerShell script:

• Run .\build.ps1 from the Z8-app directory.
• For a clean build, you may need to remove .obj files.

Testing & Validation

After implementing new features or making changes, you MUST re-test to ensure stability and performance.

Before committing changes, ensure the following checks pass:

• Style Check: Run python tools/check_style.py.
• Benchmark: Run .\z8.exe ..\TEST\benchmark_fs.js to verify performance consistency.
• FS Validation: Run .\z8.exe ..\TEST\validate_fs.js for deeper I/O checks.
• Git Hooks: Ensure python tools/install_hooks.py has been run to enable pre-commit checks.

Repository Structure

• src/: Core C++ source files.
• tools/: Development and build support tools.
• docs/: Documentation and coding style guides.
• Agent-Skills/: AI agent capability definitions (this directory).