docs: Add GitHub CLI setup instructions and task/issue workflow

- Developer guide: add gh CLI installation (Windows, macOS, Linux)
  and authentication instructions
- CLAUDE.md: document task & issue workflow — draft, confirm, create
  on GitHub via gh, maintain in tasks/ folder, reference in commits

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: AndreaV-Lsi

CLAUDE.md

@@ -106,3 +106,17 @@ tasks/
 - **Agnostic mode**: uses `"Tag"` and `"API Compatible Tags"` fields for explicit version control
 - **Repository Dictionary** (`$script:RepositoryDictionary`): central tracking structure for all repositories being processed across the dependency tree
 - **Immutable config**: once a repo's resolution mode is set, it cannot change during processing
+
+## Task & Issue Workflow
+
+Features, bugs, and enhancements are tracked in `tasks/BACKLOG.md` (planned) and `tasks/DONE.md` (completed), mirroring GitHub issues.
+
+**When the user requests a new feature or reports a bug:**
+
+1. Draft a properly formatted issue description (title + body in GitHub markdown)
+2. Ask the user for confirmation before creating
+3. Create the issue on GitHub using `gh issue create`
+4. Update `tasks/BACKLOG.md` with the issue number and description
+5. When implemented, move the entry from `BACKLOG.md` to `DONE.md` with a summary
+
+**When committing a fix or feature**, reference the GitHub issue in the commit message (`Fixes #N` or `Refs #N`)

docs/developer_guide.md

@@ -144,6 +144,42 @@ OpenSSH is bundled with the OS. LsiGitCheckout uses `GIT_SSH_COMMAND` to specify
    chmod 600 key_openssh
    ```
 
+### GitHub CLI (`gh`)
+
+The GitHub CLI is used to create and manage issues directly from the command line.
+
+**macOS:**
+
+```bash
+brew install gh
+```
+
+**Windows:**
+
+```cmd
+winget install GitHub.cli
+```
+
+**Linux (Ubuntu/Debian):**
+
+```bash
+sudo apt-get install gh
+```
+
+**Authenticate after install:**
+
+```bash
+gh auth login
+```
+
+Choose **GitHub.com**, **HTTPS**, and **Login with a web browser**. This opens a browser for OAuth — once approved, `gh` stores the token securely.
+
+**Verify:**
+
+```bash
+gh auth status
+```
+
 ### Pester 5.x (Test Framework)
 
 Install the Pester module inside PowerShell 7: