chore: sync convention docs from template

Author: euxx

AGENTS.md

@@ -2,16 +2,10 @@
 
 ## After Making Changes
 
-After modifying code, ensure to run the following commands to maintain code quality:
+After modifying code, run:
 
-- `npm run ci` - Run all checks (tests + lint + format check)
+- `npm run ci` — tests + lint + format check
 
-Or run individually:
+See [DEVELOPMENT.md](DEVELOPMENT.md) for all available scripts.
 
-- `npm run lint` - Lint code (ESLint)
-- `npm run lint:fix` - Lint and auto-fix
-- `npm run format` - Format code with Prettier
-- `npm run format:check` - Check formatting without writing
-
-Refer to [DEVELOPMENT.md](DEVELOPMENT.md) for project setup, scripts, and technical details.
-Refer to [RELEASE.md](RELEASE.md) for the release process and versioning conventions.
+See [RELEASE.md](RELEASE.md) for the release process.

DEVELOPMENT.md

@@ -15,9 +15,7 @@
 
 ## Running the Extension
 
-Open the project in VS Code and press **F5** to launch the Extension Development Host. The extension activates automatically on startup and shows Copilot usage in the status bar.
-
-You must be signed in to GitHub (`githubCopilotUsage.signIn`) and have an active Copilot subscription.
+Open the project in VS Code and press **F5** to launch the Extension Development Host. The extension activates automatically on startup.
 
 ## Scripts
 
@@ -29,16 +27,7 @@ You must be signed in to GitHub (`githubCopilotUsage.signIn`) and have an active
 | `npm run lint:fix`     | Lint and auto-fix                     |
 | `npm run format`       | Format code with Prettier             |
 | `npm run format:check` | Check code formatting                 |
-
-## Project Structure
-
-```
-src/
-├── api.js          # GitHub API call: fetch Copilot usage
-└── extension.js    # VS Code extension: status bar, commands, timer
-tests/
-└── api.test.js     # Unit tests for api.js
-```
+| `npm run package`      | Package extension as `.vsix`          |
 
 ## Testing
 
@@ -47,29 +36,33 @@ npm test     # Run all tests
 npm run ci   # Run tests + lint + format check in one step
 ```
 
-Tests use [Vitest](https://vitest.dev/) and mock `fetch` globally — no network calls are made.
-
-## Key Technical Notes
-
-- **API endpoint**: `GET https://api.github.com/copilot_internal/user`
-- **Auth**: VS Code `authentication.getSession('github', ...)` — uses the user's existing GitHub session; cancellation handled gracefully via inner try/catch
-- **Auto-refresh**: Configurable interval (1–60 min, default 5 min) via `githubCopilotUsage.refreshIntervalMinutes`
-- **Status bar position**: Priority `100.099999` — places the indicator just to the right of the Copilot icon (`chat.statusBarEntry` at `100.1`)
+Tests use [Vitest](https://vitest.dev/).
 
 ## Local Packaging
 
-To build a `.vsix` file for local installation:
-
 ```bash
-npx @vscode/vsce package --no-dependencies
+npm run package
 ```
 
-This generates `github-copilot-usage-<version>.vsix` in the project root.
-
-To install it locally in VS Code:
+This produces a `.vsix` file. To install it locally:
 
 ```bash
-code --install-extension github-copilot-usage-<version>.vsix
+code --install-extension my-extension-0.0.1.vsix
 ```
 
-Or in VS Code: **Extensions** → **···** (top-right) → **Install from VSIX…**
+Or use **Extensions: Install from VSIX** in the VS Code UI.
+
+<!-- END-SHARED -->
+
+## Notes
+
+You must be signed in to GitHub (`githubCopilotUsage.signIn`) and have an active Copilot subscription.
+
+Tests mock `fetch` globally — no network calls are made.
+
+### Key Technical Notes
+
+- **API endpoint**: `GET https://api.github.com/copilot_internal/user`
+- **Auth**: VS Code `authentication.getSession('github', ...)` — uses the user's existing GitHub session; cancellation handled gracefully via inner try/catch
+- **Auto-refresh**: Configurable interval (1–60 min, default 5 min) via `githubCopilotUsage.refreshIntervalMinutes`
+- **Status bar position**: Priority `100.099999` — places the indicator just to the right of the Copilot icon (`chat.statusBarEntry` at `100.1`)

RELEASE.md

@@ -7,36 +7,38 @@
 
 2. Update version in `package.json`:
 
-   ```sh
+   ```bash
    # Edit package.json to set "version": "X.Y.Z"
    npm install  # sync package-lock.json
    ```
 
 3. Commit and push:
 
-   ```sh
+   ```bash
    git add CHANGELOG.md package.json package-lock.json
    git commit -m "chore: update version to vX.Y.Z"
    git push origin main
    ```
 
 4. Run the release workflow:
 
-   ```sh
+   ```bash
    gh workflow run release.yml
    ```
 
-   This will run tests, package the extension as `.vsix`, and create a GitHub Release with the file attached.
+   This runs tests, packages the extension as `.vsix`, and creates a GitHub Release with the file attached.
 
-5. Verify the release was created successfully:
+5. Verify the release:
 
-   ```sh
+   ```bash
    gh release view vX.Y.Z
    ```
 
+<!-- END-SHARED -->
+
 6. Update the release notes on GitHub to match `CHANGELOG.md`:
 
-   ```sh
+   ```bash
    gh release edit vX.Y.Z --notes "## What's Changed
    - Change 1
    - Change 2