@dezkareid/ai-team 1.7.0 → 1.8.1

package/.agent-structurerc

@@ -88,7 +88,7 @@
   "mcpServers": {
     "ai-team": {
       "claude-plugin": "company-context",
-      "version": "1.7.0",
+      "version": "1.8.1",
       "package": "@dezkareid/ai-team",
       "command": "npx",
       "args": [
@@ -96,6 +96,7 @@
         "${package}@${version}"
       ],
       "contextFiles": {
+        "get_enterprise_context": "context/enterprise.md",
         "get_company_outcomes": "context/outcomes.md",
         "get_architecture_principles": "context/architecture-principles.md"
       }

package/AGENTS.md

@@ -43,6 +43,32 @@ Command content with {SCRIPT} and {{args}} placeholders.
 - **`plugins/`**: Claude Code plugins. Each subdirectory represents a plugin and contains exported versions of commands and skills in Markdown format.
 - **`.claude-plugin/`**: Metadata and configuration for Claude Code. The root folder contains the `marketplace.json`, while plugin folders contain their respective `plugin.json`.
 
+### AI Team MCP
+
+The `ai-team` MCP server provides authoritative business and architectural context.
+
+#### Available Tools
+
+| Tool | Description |
+|---|---|
+| `get_enterprise_context` | Retrieves the enterprise mission, strategic goals, and core architecture characteristics. |
+| `get_company_outcomes` | Retrieves the high-level business outcomes and key results. |
+| `get_architecture_principles` | Retrieves the technology-agnostic architecture principles. |
+| `search_product` | Dynamic tool to search for specific product characteristics. |
+
+#### Context Folder Structure
+
+```text
+context/
+├── enterprise.md              # Shared mission, goals, and core characteristics
+├── outcomes.md                # Shared strategic outcomes (OKRs)
+├── architecture-principles.md # Fundamental philosophy and standards
+└── products/                  # Product-specific characteristics
+    ├── personal-website.md
+    ├── collecstory.md
+    └── default.md             # Fallback for undocumented products
+```
+
 #### Project Configuration (`.agent-structurerc`)
 
 File `.agent-structurerc` is used to configure the project structure.
@@ -69,6 +95,11 @@ File `.agent-structurerc` is used to configure the project structure.
       "name": "web-quality",
       "version": "0.0.1",
       "description": "Skills for auditing and optimizing web quality (Performance, Accessibility, SEO, Core Web Vitals, Best Practices)"
+    },
+    "frontend-tools": {
+      "name": "frontend-tools",
+      "version": "0.0.1",
+      "description": "Expert procedural guidance for frontend development (React, Next.js, etc.)"
     }
   },
   "commands": [
@@ -118,6 +149,16 @@ File `.agent-structurerc` is used to configure the project structure.
       "name": "web-quality-audit",
       "source": "skills/web-quality-audit/SKILL.md",
       "claude-plugin": "web-quality"
+    },
+    {
+      "name": "react-best-practices",
+      "source": "skills/react-best-practices/SKILL.md",
+      "claude-plugin": "frontend-tools"
+    },
+    {
+      "name": "next-best-practices",
+      "source": "skills/next-best-practices/SKILL.md",
+      "claude-plugin": "frontend-tools"
     }
   ],
   "mcpServers": {
@@ -131,6 +172,7 @@ File `.agent-structurerc` is used to configure the project structure.
         "${package}@${version}"
       ],
       "contextFiles": {
+        "get_enterprise_context": "context/enterprise.md",
         "get_company_outcomes": "context/outcomes.md",
         "get_architecture_principles": "context/architecture-principles.md"
       }

package/README.md

@@ -37,9 +37,33 @@ claude marketplace add dezkareid-ai-team https://github.com/dezkareid/ai-team
 
 #### `company-context` — Authoritative company context and tools
 
-| MCP Server | Description |
+### AI Team MCP
+
+The `ai-team` MCP server provides authoritative business and architectural context to AI agents.
+
+#### Available Tools
+
+| Tool | Description |
 |---|---|
-| `ai-team` | Provides authoritative company context, outcomes, and architecture principles. |
+| `get_enterprise_context` | Retrieves the enterprise mission, strategic goals, and core architecture characteristics. |
+| `get_company_outcomes` | Retrieves the high-level business outcomes and key results for the enterprise. |
+| `get_architecture_principles` | Retrieves the technology-agnostic architecture principles and quality standards. |
+| `search_product` | Searches for a specific product's characteristics and goals. Returns a default profile if not found. |
+
+#### Context Structure
+
+The documentation follows a hierarchical, technology-agnostic structure:
+
+```text
+context/
+├── enterprise.md              # Mission, goals, and core characteristics
+├── outcomes.md                # Shared strategic outcomes (OKRs)
+├── architecture-principles.md # Fundamental philosophy and standards
+└── products/                  # Product-specific characteristics
+    ├── personal-website.md
+    ├── collecstory.md
+    └── default.md             # Fallback for undocumented products
+```
 
 #### `web-quality` — Skills for auditing and optimizing web quality
 
@@ -52,6 +76,13 @@ claude marketplace add dezkareid-ai-team https://github.com/dezkareid/ai-team
 | `core-web-vitals` | Optimize Core Web Vitals (LCP, INP, CLS) for better page experience and search ranking. |
 | `best-practices` | Apply modern web development best practices for security, compatibility, and code quality. |
 
+#### `frontend-tools` — Expert procedural guidance for frontend development
+
+| Skill | Description |
+|---|---|
+| `react-best-practices` | Expert guidance for React development, including hooks, performance, and patterns. |
+| `next-best-practices` | Best practices for Next.js applications, including RSC, caching, and routing. |
+
 ### Install a plugin
 
 Once the marketplace is added, install a plugin with:
@@ -61,6 +92,7 @@ claude plugin install npm-tools
 claude plugin install design-system
 claude plugin install company-context
 claude plugin install web-quality
+claude plugin install frontend-tools
 ```
 
 ## Development

package/context/architecture-principles.md

@@ -1,12 +1,31 @@
-# Architecture Principles
+# Dezkareid Enterprise: Architecture Principles
+
+These principles define the fundamental philosophy and standards for all systems designed and built by Dezkareid Enterprise. They ensure that our technology-agnostic designs remain aligned with our strategic business goals.
 
 ## Core Principles
-1. **Simplicity over Complexity**: Prefer simple, maintainable solutions over complex ones. Avoid over-engineering.
-2. **Configuration-Driven**: Design systems to be behaviorally controlled via configuration rather than hardcoded logic.
-3. **Stateless by Default**: Aim for stateless services to improve scalability and simplify deployment.
-4. **Documentation as Code**: Maintain technical documentation close to the code it describes (e.g., Markdown files in the repository).
-
-## Standards
-- **Language**: TypeScript is the primary language for all tooling.
-- **Protocol**: Use Model Context Protocol (MCP) for exposing internal context to AI agents.
-- **Testing**: All new features must include unit and/or integration tests.
+
+### 1. Simplicity over Complexity
+We prioritize simple, maintainable solutions. Avoid over-engineering and "just-in-case" complexity. If a solution is difficult to explain, it is likely too complex.
+
+### 2. Configuration-Driven Behavior
+Systems should be behaviorally controlled through external configuration and parameters rather than hard-coded logic. This enables rapid adaptation to business changes without requiring structural modifications.
+
+### 3. Statelessness and Modularity
+Aim for stateless designs and high modularity. This simplifies scalability, improves system resilience, and ensures that components can be updated or replaced with minimal impact on the broader ecosystem.
+
+### 4. Documentation as a Primary Artifact
+Technical documentation is considered a first-class citizen and must be maintained as close as possible to the logic it describes. Systems are not considered "complete" unless they are fully documented for both human and automated consumption.
+
+## Quality Standards
+
+### 1. Performance-First Design
+Performance is not an afterthought. Every architectural decision must consider its impact on system responsiveness and resource efficiency to ensure a superior user experience.
+
+### 2. Universal Accessibility
+Inclusivity is a baseline requirement. All user-facing interfaces must be designed to be accessible to everyone, regardless of their physical abilities or the devices they use.
+
+### 3. Native Discoverability
+Systems must be architected to be inherently discoverable. This includes adhering to semantic standards and structured data patterns that allow both users and external systems to easily find and index our products.
+
+### 4. Integrity and Auditability
+Data integrity and the ability to trace system state are paramount. Architecture must support clear audit trails and ensure that business logic is transparent and verifiable.

package/context/enterprise.md

@@ -0,0 +1,44 @@
+# Dezkareid Enterprise: Enterprise Context
+
+## Mission
+Empowering individuals and businesses through expert services and engaging platforms that prioritize simplicity, reliability, and continuous innovation.
+
+## Strategic Business Goals
+1. **Innovation & Growth**: Continuously launch and evolve products that solve real-world problems for collectors and professionals.
+2. **Operational Excellence**: Ensure the highest standards of reliability and performance across all services and platforms to build and maintain user trust.
+3. **High-Quality User Experience**: Deliver products that are fast, accessible to all, and easy to discover, ensuring superior usability and market reach.
+4. **Efficiency & Velocity**: Optimize internal processes and delivery models to respond quickly to market needs and user feedback.
+
+## Enterprise Architecture Characteristics (Quality Attributes)
+The following characteristics guide the design of all Dezkareid Enterprise systems, directly supporting our business goals:
+
+### 1. Performance (Supports High-Quality UX & Operational Excellence)
+- Systems must be optimized for speed and responsiveness to ensure a smooth user experience.
+- Low latency and efficient resource utilization are core requirements for all platforms.
+
+### 2. Accessibility & Usability (Supports High-Quality UX & Growth)
+- Products must be inclusive by design, adhering to modern accessibility standards (e.g., WCAG).
+- Interface and experience design must prioritize intuitive usability for all user segments.
+
+### 3. Discoverability & SEO (Supports Growth & Innovation)
+- Public-facing platforms must be optimized for search engine visibility and user discovery.
+- Structured data and semantic markup should be used to ensure products are easily found and indexed.
+
+### 4. Maintainability (Supports Efficiency)
+- Systems should be designed for long-term health and ease of updates.
+- Preference for clear, simple logic over complex, opaque solutions.
+
+### 5. Scalability (Supports Growth)
+- Architecture must support growth in user base and data volume without proportional increases in operational overhead.
+- Aim for designs that can handle increased load through horizontal expansion.
+
+### 6. Reliability & Trust (Supports Operational Excellence)
+- Systems must be dependable and resilient to failure.
+- Data integrity and availability are paramount to maintaining user confidence.
+
+## Shared Enterprise Outcomes (2026)
+- **Quality Benchmark**: Achieve and maintain a 99.9% availability target for all public-facing platforms.
+- **Performance Standards**: Ensure core product pages achieve a Google Lighthouse performance score of 90+ on mobile and desktop.
+- **Accessibility Compliance**: Reach 100% compliance with WCAG 2.1 Level AA standards for all user-facing interfaces.
+- **User Satisfaction**: Reach a minimum 85% satisfaction score across the product portfolio.
+- **Delivery Velocity**: Increase the frequency of meaningful product updates by 20% through optimized delivery frameworks.

package/context/outcomes.md

@@ -1,11 +1,31 @@
-# Company Outcomes 2026
+# Dezkareid Enterprise: Shared Strategic Outcomes (2026)
 
-## Strategic Goals
-1. **Developer Productivity**: Increase developer velocity by 20% through AI-assisted tooling and standardized workflows.
-2. **Operational Excellence**: Maintain 99.9% uptime for all core AI services and internal tools.
-3. **Innovation**: Launch at least 3 new AI-powered features that directly solve customer pain points.
+This document outlines the high-level business outcomes and key results for **Dezkareid Enterprise** and its product portfolio. These outcomes are technology-agnostic and represent our business priorities.
 
-## Key Results (OKRs)
-- **OKR 1**: 100% of engineering teams using `ai-team` CLI for routine tasks.
-- **OKR 2**: Reduce bug resolution time by 30% using automated diagnosis tools.
-- **OKR 3**: Achieve 85% developer satisfaction score in the quarterly survey.
+## Objective: Innovation & Growth
+*Continuously launch and evolve products that solve real-world problems for collectors and professionals.*
+
+**Key Results:**
+- Successfully expand the **Collecstory** user base by 50% through improved organic discoverability (SEO) and community engagement.
+- Achieve a 20% increase in lead generation for the **Personal Website** services (Consulting, Development, Mentoring) through enhanced reputation and professional visibility.
+
+## Objective: Operational Excellence
+*Ensure the highest standards of reliability and performance across all services and platforms to build and maintain user trust.*
+
+**Key Results:**
+- Maintain a 99.9% availability benchmark for all public-facing platforms and services.
+- Reduce the time-to-resolution for reported user issues by 30% through improved internal diagnostics and standard documentation.
+
+## Objective: High-Quality User Experience
+*Deliver products that are fast, accessible to all, and easy to discover, ensuring superior usability and market reach.*
+
+**Key Results:**
+- Achieve a "High Quality" performance rating for all product interfaces on core user devices.
+- Ensure 100% compliance with established accessibility standards for every user-facing platform.
+
+## Objective: Efficiency & Velocity
+*Optimize internal processes and delivery models to respond quickly to market needs and user feedback.*
+
+**Key Results:**
+- Increase the frequency of meaningful product updates and improvements by 20% by standardizing common business and design patterns.
+- Achieve a 90% "Enterprise Confidence" score in our quarterly internal review of business logic and system transparency.

package/context/products/collecstory.md

@@ -0,0 +1,15 @@
+# Product: Collecstory (Collector Platform)
+
+## Overview
+An application and social platform for collectionism. It allows users to track their card and figure collections, share their progress through photography and sessions, and discover or purchase new items.
+
+## Core Business Goals
+- **User Engagement**: Foster a vibrant, active community of collectors through superior usability.
+- **Community Growth**: Expand the user base by being highly discoverable via SEO and social sharing.
+- **Marketplace Facilitation**: Become a trusted destination for discovering, finding, and sourcing collection items by optimizing for product discovery.
+
+## Product-Specific Characteristics
+- **Visual Performance**: Optimizing for high-performance image and media delivery to provide a fluid user experience.
+- **Universal Accessibility**: Ensuring all users can manage and enjoy their collections regardless of device or ability.
+- **Search Engine Visibility**: Strong focus on SEO and semantic data (e.g., Schema.org) for cards and collectibles to drive organic traffic.
+- **Discovery-Focused**: Tools and features to help users easily find and buy missing pieces.

package/context/products/default.md

@@ -0,0 +1,15 @@
+# Product: Default Characteristics
+
+## Overview
+This document defines the common characteristics and business alignment for products within the Dezkareid Enterprise that do not yet have a specific documentation file.
+
+## Core Business Goals
+- **Strategic Alignment**: All products must support the Enterprise mission of empowering individuals and businesses.
+- **Value Delivery**: Focus on solving real-world problems and providing tangible benefits to users.
+- **Operational Excellence**: Adhere to enterprise-wide standards for reliability and performance.
+
+## Common Product Characteristics
+- **Simplicity**: Minimalist design and intuitive user experience.
+- **Quality-First**: High standards for performance, accessibility, and discoverability.
+- **Data Integrity**: Commitment to secure and reliable data management.
+- **Continuous Evolution**: Built for flexibility and rapid iteration based on user feedback.

package/context/products/personal-website.md

@@ -0,0 +1,15 @@
+# Product: Personal Website (Services Business)
+
+## Overview
+A platform dedicated to providing professional services in consulting, development, and mentoring. It represents the "Expert Services" pillar of the enterprise.
+
+## Core Business Goals
+- **Reputation & Authority**: Establish Dezkareid Enterprise as a leader in technical excellence and mentorship.
+- **Client Success**: Deliver high-value consulting and development that results in measurable success for clients.
+- **Discoverability**: Ensure potential clients can easily find services through search engines and professional networks.
+
+## Product-Specific Characteristics
+- **Performance & Loading Speed**: Fast-loading pages for a professional first impression and better search rankings.
+- **Accessibility**: A fully accessible experience ensuring services are available to all potential clients.
+- **Expertise-Driven**: Content and outcomes are directly based on the unique expertise of the Enterprise.
+- **Outcome-Oriented**: Focus on achieving tangible client goals.

package/dist/mcp-server/index.js

@@ -23220,6 +23220,52 @@ async function main() {
         name: 'ai-team',
         version: config.version,
     });
+    // Register search_product tool
+    server.registerTool('search_product', {
+        description: 'Searches for a product in the Dezkareid Enterprise portfolio and returns its characteristics.',
+        inputSchema: z.object({
+            productName: z.string().describe('The name of the product to search for (e.g., "collecstory", "personal-website")'),
+        }),
+    }, async ({ productName }) => {
+        const normalizedName = productName.toLowerCase().replace(/\s+/g, '-');
+        const productPath = path.join(rootDir, 'context', 'products', `${normalizedName}.md`);
+        const defaultPath = path.join(rootDir, 'context', 'products', 'default.md');
+        try {
+            if (fileExists(productPath)) {
+                const content = readFileContent(productPath);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: content,
+                        },
+                    ],
+                };
+            }
+            else {
+                const content = readFileContent(defaultPath);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `The products was not found but here are the default enterprise product characteristics:\n\n${content}`,
+                        },
+                    ],
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error reading product content: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
     // Register tools based on contextFiles mapping
     for (const toolName of Object.keys(contextFiles)) {
         const relativePath = contextFiles[toolName];

package/gemini-extension.json

@@ -1,12 +1,12 @@
 {
   "name": "dezkareid-ai-team",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "mcpServers": {
     "ai-team": {
       "command": "npx",
       "args": [
         "-y",
-        "@dezkareid/ai-team@1.7.0"
+        "@dezkareid/ai-team@1.8.1"
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dezkareid/ai-team",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Repository for AI Team",
   "type": "module",
   "main": "index.js",