{
  "markdown": "# Integration Architect Skill Suite 🚀\n\nAn autonomous, multi-skill suite for the **Integration Architect** lifecycle. It bridges the gap between legacy technical systems and modern mobile frontend requirements using a **Compute-First, Deterministic** approach.\n\n## 🛠 Skills Included\n\n1. **`integration-architect`**: The Master Orchestrator. Manages the 5-phase lifecycle.\n2. **`discovery-expert`**: Technical Source understanding (Word/PowerPoint/Excel/CSV to OpenAPI/Schema Map).\n3. **`ui-analyzer`**: User Target understanding (Figma/Screenshot to UI Spec).\n4. **`contract-designer`**: The Bridge (Optimized OpenAPI & TypeScript Types).\n5. **`data-aligner`**: Persistence Layer (DB Gap Analysis & SQL Alignment).\n6. **`quality-architect`**: Verification Layer (Postman, K6, and Mocks).\n\n## 📦 Installation\n\n### Option A: Claude Code Plugin (Recommended)\nInstall directly within Claude Code using the `/plugin` command:\n```\n/plugin install https://github.com/pongsatorna/integration-architect-agent\n```\n\nAfter installation, use the `/integrate` slash command to start the lifecycle:\n```\n/integrate              # Run full 5-phase lifecycle\n/integrate discovery    # Start from a specific phase\n```\n\n**Figma MCP Setup:** Set your Figma token as an environment variable:\n```bash\nexport FIGMA_ACCESS_TOKEN=\"your-figma-personal-access-token\"\n```\n\n### Option B: Antigravity CLI (Gemini)\nTo install the entire suite of skills as an Antigravity plugin:\n```bash\nagy plugin install https://github.com/pongsatorna/integration-architect-agent\n```\n\n### Option C: Individual Skills (Manual)\nClone the repository and symlink specific skills to your local workspace:\n```bash\ngit clone https://github.com/pongsatorna/integration-architect-agent.git\nmkdir -p .agents/skills\nln -s $(pwd)/integration-architect-agent/skills/integration-architect .agents/skills/\nln -s $(pwd)/integration-architect-agent/skills/discovery-expert .agents/skills/\n# etc...\n```\n\n## ⚙️ Prerequisites\n\nThese skills are **Self-Healing**. The agent will automatically attempt to install the following if missing:\n- **Python 3.12+**\n- **Libraries:** `pandas`, `mammoth`, `python-docx`, `python-pptx`, `openpyxl`, `pyyaml`\n\n### Figma MCP Setup\nTo enable high-fidelity UI analysis, you need to configure the **Figma MCP Server**.\n\n**For Claude Code (Option A):** The `.mcp.json` is bundled with the plugin — just set the environment variable:\n```bash\nexport FIGMA_ACCESS_TOKEN=\"your-figma-personal-access-token\"\n```\n\n**For Antigravity/Gemini (Option B):** Since the Antigravity CLI (`agy`) scans the workspace root, this configuration **must** be placed in `.agents/mcp_config.json` at the root of your project (not inside `./discovery/`).\n\nCreate the file `.agents/mcp_config.json` in the root of your project:\n```json\n{\n  \"mcpServers\": {\n    \"figma\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-figma\"\n      ],\n      \"env\": {\n        \"FIGMA_ACCESS_TOKEN\": \"YOUR_FIGMA_PERSONAL_ACCESS_TOKEN\"\n      }\n    }\n  }\n}\n```\n*Note: Replace `YOUR_FIGMA_PERSONAL_ACCESS_TOKEN` with your actual Figma Personal Access Token.*\n\n## 📂 Workspace Structure\n\n### User-Created Input Folders (Must be set up before running):\n- `./discovery/`: Place your legacy API docs (`.docx`, `.pptx`, `.xlsx`) and database schema exports (`.csv`) here.\n- `./ui_analysis/screenshots/`: Place UI mockups/screenshots here (if not using the Figma MCP server).\n\n### Agent-Created Output Folders (Created automatically at runtime):\n- `./contracts/`: Final OpenAPI specs, TypeScript types, and lineage maps.\n- `./database/`: SQL alignment scripts and database migration plans.\n- `./testing/`: Postman collections, K6 load test scripts, and mock response JSONs.\n\n---\n**Build with ❤️ for Integration Architects.**\n",
  "bytes": 3778,
  "sha": "6ade224d7ed9fe98ea1ea07c86f83969d96420e2f79689f1621f546dcaf1e82e",
  "repo_slug": "pongsatorna/integration-architect-agent",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pongsatorna_integration_architect_agent_dd87e6a1/readme"
}