Skip to content

workflows.md

Latest commit

 

History

History
31 lines (23 loc) · 1.67 KB

workflows.md

File metadata and controls

31 lines (23 loc) · 1.67 KB
Raw

Workflows

Startup/session protocol is defined in AGENTS.md (Start Here (Mandatory)). This file only covers execution details.

Editing Rules

  • Do not hand-edit generated outputs in example modules such as core, shared/<Lib>-jni, shared/<Lib>-c, desktop/<Lib>-desktop-ffm, or web/<Lib>-web; native packaging modules such as desktop/<Lib>-desktop-jni, desktop/<Lib>-desktop-c, android/<Lib>-android, and android/<Lib>-android-c should only package generated native outputs.
  • Prefer edits in source modules (base, parser modules, build modules).
  • If generator logic changes, regenerate artifacts before app/test validation.
  • When modules/tasks are renamed, update AGENTS.md, README.md, and related docs in the same change.
  • Validate documentation command/module names against settings.gradle.kts and Gradle task definitions.
  • Keep code comments short and only where needed for non-obvious logic.

Verification Minimum

Use at least one compile or test task relevant to changed modules. Examples:

  • gradlew.bat :jParser:jParser-core:compileJava
  • gradlew.bat :examples:TestLib:app:platforms:desktop-jni:test
  • gradlew.bat :examples:TestLib:app:platforms:desktop-ffm:test

Handoff Checklist

  • .agents/agents_memory.md includes:
    • what changed
    • why it changed
    • validation result
    • next recommended task
  • Keep .agents/agents_memory.md as rolling current state: replace/update prior entries instead of appending history.
  • Use .agents/agents_plan.md for active multi-step work, and clear or rewrite it when the scope changes or completes.
  • Mention any environment blockers explicitly (toolchain, missing native artifacts, classifier jars).