WIP

Author: habedi

AI_USAGE_POLICY.md

@@ -28,6 +28,9 @@ would like to work on or if it has already been resolved.
 
 ### Development Workflow
 
+> [!IMPORTANT]
+> If you're using an AI-assisted coding tool like Claude Code or Codex, make sure the AI follows the instructions in the [AGENTS.md](AGENTS.md) file.
+
 #### Prerequisites
 
 Install GNU Make on your system if it's not already installed.

CONTRIBUTING.md

@@ -6,24 +6,24 @@ It outlines features to be implemented and their current status.
 > [!IMPORTANT]
 > This roadmap is a work in progress and is subject to change.
 
--   **Command Structure**
+- **Command Structure**
     -   [x] Nested commands and subcommands
     -   [x] Command aliases and single-character shortcuts
     -   [x] Persistent flags (flags on parent commands are available to children)
 
--   **Argument & Flag Parsing**
+- **Argument & Flag Parsing**
     -   [x] Long flags (`--verbose`), short flags (`-v`), and grouped boolean flags (`-vf`)
     -   [x] Positional Arguments (supports required, optional, and variadic)
     -   [x] Type-safe access for flags and arguments (e.g., `ctx.getFlag("count", i64)`)
     -   [x] Reading flag values from environment variables
 
--   **Help & Usage Output**
+- **Help & Usage Output**
     -   [x] Automatic and context-aware `--help` flag
     -   [x] Automatic `--version` flag
     -   [x] Clean, aligned help output for commands, flags, and arguments
     -   [x] Grouping subcommands into custom sections
 
--   **Developer Experience**
+- **Developer Experience**
     -   [x] Simple, declarative API for building commands
     -   [x] Named access for all flags and arguments
     -   [x] Shared context data for passing application state