the-agency-cli 1.1.1__tar.gz

the_agency_cli-1.1.1/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include skills *.md

the_agency_cli-1.1.1/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: the-agency-cli
+Version: 1.1.1
+Summary: The Virtual IT Team in Your Pocket. A framework of 28 AI Personas for enterprise software development.
+Author: flegare
+License: MIT
+Project-URL: Homepage, https://github.com/flegare/the_agency
+Project-URL: Issues, https://github.com/flegare/the_agency/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: requests>=2.31.0
+
+# The Agency
+
+## The Virtual IT Team in Your Pocket 🏢
+
+"The Agency" is an open-source framework that models a complete, 28-person Enterprise Software Development Organization using specialized AI Personas (Skills).
+
+Unlike traditional orchestration frameworks (like CrewAI, AutoGen, or LangGraph) that just provide the *code* to connect agents, `The Agency` provides the actual **Domain Knowledge, Organizational Chart, and Standard Operating Procedures (SOPs)** required to build robust software.
+
+Simply inject these personas into your favorite AI tool (Cursor, Roo Code, Gemini CLI, or a local instance of Ollama) and watch the Virtual IT Team design, develop, secure, test, and market your application.
+
+---
+
+## 👥 The Organization Chart
+
+The Virtual IT Team comprises specialized "Skills", mapped precisely to a modern tech enterprise:
+
+- **Management:** `project_manager`, `historian`, `workspace_manager`
+- **Architecture:** `solution_architect`, `cmo_analyst` (Digital Twin Owner), `sre_cloud_architect`
+- **Development:** `backend_developer`, `frontend_developer`, `coder`
+- **Design:** `ux_ui_designer`
+- **Data Engineering:** `relational_dba`, `graph_database_architect`, `data_scientist`
+- **Quality Assurance:** `chief_test_officer`, `qa_automation_engineer`, `test_engineer`, `e2e_journey_tester`, `test_data_manager`, `ui_qa_engineer`
+- **Security:** `chief_information_security_officer`, `application_security_engineer`, `security_operations_analyst`
+- **Deployment:** `ssdlc_manager`
+- **Management & Marketing:** `head_of_marketing`, `product_marketing_manager`, `content_copywriter`, `technical_writer`
+- **Support & AI Ops:** `customer_support_triage`, `prompt_engineer`, `makefile_orchestrator`
+- **Meta-Skills (The Creators):** `skill_creator` (Organizational Architect), `tool_smith` (Internal Tooling)
+
+*(Read each `SKILL.md` inside the `skills/` folder to review the specific heuristics and constraints of that role).*
+
+---
+
+## 🚀 How to Use "The Agency"
+
+Because The Agency defines *logic* and *processes* rather than hard-coded python scripts, you can use it conceptually within any environment.
+
+### 1. The Global Agency CLI (Recommended)
+The most powerful way to use "The Agency" is to install it globally on your system path. This allows you to spawn any persona directly into whichever project directory you are currently working in.
+
+Because "The Agency" is written in Python, the recommended way to install it globally without breaking your system packages is via `pipx`.
+
+```bash
+# Install the CLI globally in an isolated environment
+pipx install the-agency-cli
+
+# Navigate to any of your completely separate projects
+cd /my/super/secret/startup/
+
+# Launch the interactive CLI right there
+agency
+```
+
+The CLI will guide you through:
+- **Initialize & Configure:** Automatically scans for AI assistants like Cursor (`.cursorrules`), Gemini (`.gemini`), Roo Code (`.clinerules`), and Claude (`CLAUDE.md`). It installs the Agency skills into your `.agency/` folder and injects specialized system logic into your AI tool's project memory so they know *how* to use the skills!
+- **Browse Skills:** View the organizational chart and understand what every department does.
+- **Run Skill:** Choose a specific skill, paste a task, and the agent will immediately context-switch into your codebase to start working.
+
+### 2. In Premium Agentic Tools (Cursor, Roo Code, Copilot Workspaces)
+Point your AI assistant at the specific `SKILL.md` you want it to embody. 
+For example, tell Cursor: *"Embody the role defined in `skills/frontend_developer/SKILL.md` and complete this task."*
+
+### 3. Pure Makefiles & Terminal Piping
+If you prefer raw execution, you can completely ignore `.agency.py` and run sequential generation using the `Makefile` pattern.
+
+**See the example `Makefile` in the root directory for a proof-of-concept pipeline.**
+
+```bash
+# Example: Generate an application schema using a local 8B model
+make build-schema 
+```
+
+### 4. Supercharging Skills with Tools
+While skills have "Brains", they need "Hands" to affect the local machine. By installing common CLI tools globally on your terminal (e.g., `semgrep`, `docker`, `playwright`), you empower the agents to use those tools automatically via `run_command` capabilities.
+
+**[Read the Recommended Tools Architecture](docs/architecture/recommended_tools.md)** to see which open-source CLIs pair best with which Virtual Employee. If a tool you need doesn't exist, spawn the `tool_smith` meta-skill to write a custom wrapper!
+
+---
+
+## 📦 Integrating into an Existing Project
+
+If you are not starting from scratch, you can easily drop "The Agency" into a mature, existing repository.
+
+**1. Call the `agency` command and select "Initialize"**
+The `agency init` command does two massive things:
+- It automatically configures whatever native AI tool you use (Cursor, Cline, Gemini, Aider) with the Agency's context and instructions.
+- It copies the entire `skills/` directory into your `.agency/` folder.
+
+**2. Initialize the "Digital Twin" (The Most Important Step)**
+AI agents hallucinate when they don't know your existing architecture. Before asking the Agency to write new code for your existing app, you must map your current state. From the `agency` initialization menu, select **"Map Digital Twin"**:
+*   The `historian` reads your files to summarize the project's purpose.
+*   The `solution_architect` maps the `src/` hierarchy to build a system architecture.
+*   The `cmo_analyst` aggregates this into a master "Digital Twin" state document at `docs/cmo_state.md`.
+
+**3. Resume Normal Operations**
+Once properly mapped and configured, your native AI editor (like Cursor or Gemini) naturally understands your new virtual employees and the structure of your application. Ask your IDE directly: *"Tell the `backend_developer` to build a new auth route according to the architecture."*
+
+---
+
+## 🏗️ The Project Lifecycle
+
+If you elect to use the full agency, follow the routing lifecycle governed by the `project_manager`:
+
+1. **Discovery:** `cmo_analyst` checks the system's "Digital Twin" constraints (`docs/`).
+2. **Design Blueprint:** `ux_ui_designer` maps the wireframes; `prompt_engineer` maps the LLM context flow.
+3. **Architecture:** `solution_architect` defines the data models and component structure.
+4. **Security Check:** `ciso` reviews the architecture for vulnerabilities. *(Must pass before coding).*
+5. **Implementation:** Specialized `backend_developer` and `frontend_developer` write the code.
+6. **Testing:** `chief_test_officer` coordinates unit, integration, and E2E tests.
+7. **Deployment:** `sre_cloud_architect` dictates topology, and `ssdlc_manager` routes it to production.
+8. **Launch:** The Marketing division generates go-to-market copy while the `technical_writer` builds the public APIs.
+
+---
+
+## 📜 Legacy Assets
+Older, hard-coded Python SDK variants of this agentic framework have been archived in the `legacy/` folder for historical reference. The future of The Agency is agnostic, prompt-driven markdown injected into powerful local or cloud execution layers.
+
+## Contributing
+Want to add a new role to the IT Team? 
+1. Copy an existing `SKILL.md`.
+2. Define their Core Responsibilities and Workflow Integration.
+3. Submit a PR.

the_agency_cli-1.1.1/README.md

@@ -0,0 +1,121 @@
+# The Agency
+
+## The Virtual IT Team in Your Pocket 🏢
+
+"The Agency" is an open-source framework that models a complete, 28-person Enterprise Software Development Organization using specialized AI Personas (Skills).
+
+Unlike traditional orchestration frameworks (like CrewAI, AutoGen, or LangGraph) that just provide the *code* to connect agents, `The Agency` provides the actual **Domain Knowledge, Organizational Chart, and Standard Operating Procedures (SOPs)** required to build robust software.
+
+Simply inject these personas into your favorite AI tool (Cursor, Roo Code, Gemini CLI, or a local instance of Ollama) and watch the Virtual IT Team design, develop, secure, test, and market your application.
+
+---
+
+## 👥 The Organization Chart
+
+The Virtual IT Team comprises specialized "Skills", mapped precisely to a modern tech enterprise:
+
+- **Management:** `project_manager`, `historian`, `workspace_manager`
+- **Architecture:** `solution_architect`, `cmo_analyst` (Digital Twin Owner), `sre_cloud_architect`
+- **Development:** `backend_developer`, `frontend_developer`, `coder`
+- **Design:** `ux_ui_designer`
+- **Data Engineering:** `relational_dba`, `graph_database_architect`, `data_scientist`
+- **Quality Assurance:** `chief_test_officer`, `qa_automation_engineer`, `test_engineer`, `e2e_journey_tester`, `test_data_manager`, `ui_qa_engineer`
+- **Security:** `chief_information_security_officer`, `application_security_engineer`, `security_operations_analyst`
+- **Deployment:** `ssdlc_manager`
+- **Management & Marketing:** `head_of_marketing`, `product_marketing_manager`, `content_copywriter`, `technical_writer`
+- **Support & AI Ops:** `customer_support_triage`, `prompt_engineer`, `makefile_orchestrator`
+- **Meta-Skills (The Creators):** `skill_creator` (Organizational Architect), `tool_smith` (Internal Tooling)
+
+*(Read each `SKILL.md` inside the `skills/` folder to review the specific heuristics and constraints of that role).*
+
+---
+
+## 🚀 How to Use "The Agency"
+
+Because The Agency defines *logic* and *processes* rather than hard-coded python scripts, you can use it conceptually within any environment.
+
+### 1. The Global Agency CLI (Recommended)
+The most powerful way to use "The Agency" is to install it globally on your system path. This allows you to spawn any persona directly into whichever project directory you are currently working in.
+
+Because "The Agency" is written in Python, the recommended way to install it globally without breaking your system packages is via `pipx`.
+
+```bash
+# Install the CLI globally in an isolated environment
+pipx install the-agency-cli
+
+# Navigate to any of your completely separate projects
+cd /my/super/secret/startup/
+
+# Launch the interactive CLI right there
+agency
+```
+
+The CLI will guide you through:
+- **Initialize & Configure:** Automatically scans for AI assistants like Cursor (`.cursorrules`), Gemini (`.gemini`), Roo Code (`.clinerules`), and Claude (`CLAUDE.md`). It installs the Agency skills into your `.agency/` folder and injects specialized system logic into your AI tool's project memory so they know *how* to use the skills!
+- **Browse Skills:** View the organizational chart and understand what every department does.
+- **Run Skill:** Choose a specific skill, paste a task, and the agent will immediately context-switch into your codebase to start working.
+
+### 2. In Premium Agentic Tools (Cursor, Roo Code, Copilot Workspaces)
+Point your AI assistant at the specific `SKILL.md` you want it to embody. 
+For example, tell Cursor: *"Embody the role defined in `skills/frontend_developer/SKILL.md` and complete this task."*
+
+### 3. Pure Makefiles & Terminal Piping
+If you prefer raw execution, you can completely ignore `.agency.py` and run sequential generation using the `Makefile` pattern.
+
+**See the example `Makefile` in the root directory for a proof-of-concept pipeline.**
+
+```bash
+# Example: Generate an application schema using a local 8B model
+make build-schema 
+```
+
+### 4. Supercharging Skills with Tools
+While skills have "Brains", they need "Hands" to affect the local machine. By installing common CLI tools globally on your terminal (e.g., `semgrep`, `docker`, `playwright`), you empower the agents to use those tools automatically via `run_command` capabilities.
+
+**[Read the Recommended Tools Architecture](docs/architecture/recommended_tools.md)** to see which open-source CLIs pair best with which Virtual Employee. If a tool you need doesn't exist, spawn the `tool_smith` meta-skill to write a custom wrapper!
+
+---
+
+## 📦 Integrating into an Existing Project
+
+If you are not starting from scratch, you can easily drop "The Agency" into a mature, existing repository.
+
+**1. Call the `agency` command and select "Initialize"**
+The `agency init` command does two massive things:
+- It automatically configures whatever native AI tool you use (Cursor, Cline, Gemini, Aider) with the Agency's context and instructions.
+- It copies the entire `skills/` directory into your `.agency/` folder.
+
+**2. Initialize the "Digital Twin" (The Most Important Step)**
+AI agents hallucinate when they don't know your existing architecture. Before asking the Agency to write new code for your existing app, you must map your current state. From the `agency` initialization menu, select **"Map Digital Twin"**:
+*   The `historian` reads your files to summarize the project's purpose.
+*   The `solution_architect` maps the `src/` hierarchy to build a system architecture.
+*   The `cmo_analyst` aggregates this into a master "Digital Twin" state document at `docs/cmo_state.md`.
+
+**3. Resume Normal Operations**
+Once properly mapped and configured, your native AI editor (like Cursor or Gemini) naturally understands your new virtual employees and the structure of your application. Ask your IDE directly: *"Tell the `backend_developer` to build a new auth route according to the architecture."*
+
+---
+
+## 🏗️ The Project Lifecycle
+
+If you elect to use the full agency, follow the routing lifecycle governed by the `project_manager`:
+
+1. **Discovery:** `cmo_analyst` checks the system's "Digital Twin" constraints (`docs/`).
+2. **Design Blueprint:** `ux_ui_designer` maps the wireframes; `prompt_engineer` maps the LLM context flow.
+3. **Architecture:** `solution_architect` defines the data models and component structure.
+4. **Security Check:** `ciso` reviews the architecture for vulnerabilities. *(Must pass before coding).*
+5. **Implementation:** Specialized `backend_developer` and `frontend_developer` write the code.
+6. **Testing:** `chief_test_officer` coordinates unit, integration, and E2E tests.
+7. **Deployment:** `sre_cloud_architect` dictates topology, and `ssdlc_manager` routes it to production.
+8. **Launch:** The Marketing division generates go-to-market copy while the `technical_writer` builds the public APIs.
+
+---
+
+## 📜 Legacy Assets
+Older, hard-coded Python SDK variants of this agentic framework have been archived in the `legacy/` folder for historical reference. The future of The Agency is agnostic, prompt-driven markdown injected into powerful local or cloud execution layers.
+
+## Contributing
+Want to add a new role to the IT Team? 
+1. Copy an existing `SKILL.md`.
+2. Define their Core Responsibilities and Workflow Integration.
+3. Submit a PR.