docs: fix team-ai-directives URL examples in documentation

Replace invalid .git URLs with valid archive/ZIP URLs:
- README.md: Update examples to use archive URLs
- docs/installation.md: Add archive URL examples
- docs/discovery.md: Fix example to use archive URL
- docs/quickstart.md: Fix example to use archive URL

The validation logic only accepts:
- Local directory paths
- ZIP file URLs (ending in .zip)
- GitHub archive URLs (containing /archive/)

The .git URL format is rejected by design.

Author: kanfil

README.md

@@ -371,11 +371,14 @@ This fork includes pre-installed extensions:
 This fork supports team-ai-directives — a foundation for version-controlled AI agent behavior. Install during project initialization:
 
 ```bash
-# Install from GitHub repository (ZIP download)
-specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives.git
+# Install from GitHub archive (ZIP download)
+specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/heads/main.zip
 
 # Or from a specific release tag
 specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/tags/v1.0.0.zip
+
+# Or use a local directory
+specify init <project> --team-ai-directives ~/workspace/team-ai-directives
 ```
 
 The directives are installed to `.specify/extensions/team-ai-directives/` and available to all AI agents via the extension system. Use the `levelup` extension to contribute back to team-ai-directives.

docs/discovery.md

@@ -282,9 +282,9 @@ $skillsJson = Discover-Skills -FeatureDescription $featureDescription -TeamDirec
 ### Example 1: New Feature with Team Directives
 
 ```bash
-# Initialize project with team-ai-directives
+# Initialize project with team-ai-directives (from GitHub archive)
 cd my-project
-specify init . --team-ai-directives https://github.com/my-org/team-ai-directives.git
+specify init . --team-ai-directives https://github.com/my-org/team-ai-directives/archive/refs/heads/main.zip
 
 # Create feature
 ./create-new-feature.sh --json "Add user authentication with OAuth2"

docs/installation.md

@@ -75,8 +75,11 @@ Connect to shared team knowledge and standards:
 # Use local team-ai-directives directory
 uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives ~/workspace/team-ai-directives
 
-# Clone from remote repository
-uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives https://github.com/your-org/team-ai-directives.git
+# Install from GitHub archive (ZIP download)
+uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/heads/main.zip
+
+# Or from a specific release tag
+uvx --from git+https://github.com/tikalk/agentic-sdlc-spec-kit.git specify init <project_name> --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/tags/v1.0.0.zip
 ```
 
 ## Verification

docs/quickstart.md

@@ -12,7 +12,7 @@ This guide will help you get started with Spec-Driven Development using Agentic
 **Alignment with 12 Factors:** This stage establishes the foundation guided by [I. Strategic Mindset](https://tikalk.github.io/agentic-sdlc-12-factors/content/strategic-mindset.html) and [II. Context Scaffolding](https://tikalk.github.io/agentic-sdlc-12-factors/content/context-scaffolding.html), positioning the developer as orchestrator and assembling necessary context for AI collaboration.
 
 1. **Project Initialization (`/init`)**  
-   **Action:** From the project root, run the Agentic SDLC Spec Kit `init` command (e.g., `specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives.git`) to configure local settings and clone the shared `team-ai-directives` modules.  
+   **Action:** From the project root, run the Agentic SDLC Spec Kit `init` command (e.g., `specify init <project> --team-ai-directives https://github.com/your-org/team-ai-directives/archive/refs/heads/main.zip`) to configure local settings and install the shared `team-ai-directives` modules.  
    **Purpose:** Creates the handshake that brings the repository into the managed Agentic SDLC ecosystem, wiring credentials, endpoints, and shared knowledge needed for subsequent commands.
 2. **Establishing the Constitution (`/constitution`)**  
    **Action:** Within the IDE, execute `/constitution`, importing relevant modules from `team-ai-directives` and adding any project-specific principles.