Skill: johnsmithfan/ai-company-framework (version 3.0.2)

--- name: "AI Company Framework" slug: "ai-company-framework" version: "3.0.0" homepage: "https://clawhub.com/skills/ai-company-framework" description: | Framework skill: ClawHub Schema compliance, naming conventions, skill standardization, modularization, generalization, ecosystem registry, skill learning pipeline, starter scaffolding. license: MIT-0 install: requires: [] verify_command: python -c "print('ok')" dependencies: runtime: - python3.9+ skills: ["ai-company-hq","ai-company-harness"] tags: [ai-company,framework,schema,standardization,modularization,generalization,registry,pipeline,starter] triggers: - schema compliance - skill standardization - modularization - generalization - ecosystem registry - skill learning - skill scaffolding - naming conventions interface: inputs: type: object schema: type: object properties: task: type: string description: Task description context: type: object description: Optional context information required: [task] outputs: type: object schema: type: object properties: result: type: string description: Operation result report: type: object description: Detailed report data required: [result] errors: - code: FW_001 message: "Schema validation failed" - code: FW_002 message: "Modularization violation" - code: FW_003 message: "Registry lookup failed" - code: FW_004 message: "Learning pipeline error" - code: FW_005 message: "Scaffolding generation failed" permissions: files: [read, write] network: [api] commands: [] mcp: [sessions_send, subagents] quality: saST: Pass vetter: Approved idempotent: true metadata: category: infrastructure layer: AGENT cluster: ai-company maturity: STABLE license: MIT-0 standardized: true department: framework-and-infrastructure merged_from: [ai-company-standardization, ai-company-modularization, ai-company-generalization, ai-company-ecosystem, ai-company-registry, ai-company-skill-learner, ai-company-starter] --- # AI Company Framework v3.0.0 > Index & Quick Reference. Full specifications in [references/method-patterns.md](references/method-patterns.md). ## Quick Reference ### Role AI Company Framework — Framework skill: ClawHub Schema compliance, naming conventions, skill standardization, modularization, generalization, ecosystem registry, skill learning pipeline, starter scaffolding. ### Department Framework & Infrastructure ### Merged From [ai-company-standardization, ai-company-modularization, ai-company-generalization, ai-company-ecosystem, ai-company-registry, ai-company-skill-learner, ai-company-starter] ## Section Index - [1. Trigger Scenarios](references/method-patterns.md#1-trigger-scenarios) - [2. Core Identity](references/method-patterns.md#2-core-identity) - [3. Core Responsibilities](references/method-patterns.md#3-core-responsibilities) - [4. Constraints](references/method-patterns.md#4-constraints) ## Dependencies See frontmatter `dependencies.skills` for complete dependency list. ## Error Codes See frontmatter `interface.errors` for complete error code reference. ## Prompts Copy-paste ready prompts in [prompts/](prompts/): - [01-implement-method.md](prompts/01-implement-method.md) - [02-robustness-checks.md](prompts/02-robustness-checks.md) - [03-test-cases.md](prompts/03-test-cases.md) - [04-documentation.md](prompts/04-documentation.md) - [05-workflow-execution.md](prompts/05-workflow-execution.md) ## Changelog | Version | Date | Changes | |---------|------|---------| | 3.0.0 | 2026-04-26 | Full English rewrite; department-aligned structure; merged skills consolidated | --- *This skill follows AI Company Governance Framework. See [references/method-patterns.md](references/method-patterns.md) for complete specifications.* ## Integration & Merge History **v3.0.0 Rebuild (2026-04-26)** This skill was created by merging multiple predecessor skills into a unified department-aligned structure. **Department**: Infrastructure **Merged From** (8 skills total): - Framework (primary) - ai-company-standardization - ai-company-modularization - ai-company-generalization - ai-company-ecosystem - ai-company-registry - ai-company-skill-learner - ai-company-starter **Merge Rationale**: - Consolidate related capabilities under single department owner - Reduce skill count from 47 to 15 for better maintainability - Preserve all functionality while improving discoverability - Standardize structure: SKILL.md (index) + references/method-patterns.md (details) **Integration Points**: - All predecessor skill triggers preserved in unified trigger list - All predecessor interfaces consolidated with consistent error codes - Dependencies unified and simplified - Prompts merged and organized by function **Migration Guide**: - Previous skill users: Use new unified skill slug `ai-company-framework` - All functionality from predecessor skills is available - Error codes may have changed - see Error Codes section - Prompts are now user copy-paste ready (not auto-call)

path: prompts/01-implement-method.md
content: # Implementation Method Prompt

> Copy and paste this prompt into any AI chat window to implement the AI Company Framework skill.

---

## Prompt

```
You are implementing the AI Company Framework skill for an AI Company system.

Department: Framework & Infrastructure
Skill: AI Company Framework

Your task:
1. Read the SKILL.md index to understand the skill scope
2. Read references/method-patterns.md for detailed specifications
3. Implement the core methods described in the method patterns
4. Ensure all output follows the specified format
5. Verify compliance with Harness Engineering L1-L6

Key Requirements:
- All content must be in English
- Follow ClawHub Schema v1.0 for frontmatter
- Implement all error codes defined in interface.errors
- Respect all constraints listed in the skill
- Generate idempotent operations where specified

Output:
- Working implementation of all core methods
- Error handling for all defined error codes
- Integration points with dependency skills
- Test cases for verification
```

---

*Copy-paste ready for any AI chat window. Not intended for automated agent invocation.*


path: prompts/02-robustness-checks.md
content: # Robustness Checks Prompt

> Copy and paste this prompt into any AI chat window to verify the AI Company Framework skill robustness.

---

## Prompt

```
You are performing robustness checks on the AI Company Framework skill.

Department: Framework & Infrastructure
Skill: AI Company Framework

Check the following:

1. BOUNDARY CONDITIONS
   - What happens with empty input?
   - What happens with maximum-size input?
   - What happens with invalid input types?
   - What happens with concurrent access?

2. ERROR HANDLING
   - Are all error codes properly handled?
   - Are error messages user-friendly?
   - Is error recovery possible?
   - Are errors logged for audit?

3. CONSTRAINT COMPLIANCE
   - Are all skill constraints enforced?
   - Are permission boundaries respected?
   - Are SLA targets achievable?
   - Are resource limits respected?

4. INTEGRATION
   - Are dependency skills properly called?
   - Are cross-agent interfaces correct?
   - Is HQ routing followed?
   - Are audit trails complete?

5. SECURITY
   - No credentials or PII exposed?
   - No injection vulnerabilities?
   - Proper access control enforced?
   - CISO security gate requirements met?

Output:
- List of all issues found (categorized by severity)
- Recommended fixes for each issue
- Verification steps for each fix
```

---

*Copy-paste ready for any AI chat window. Not intended for automated agent invocation.*


path: prompts/03-test-cases.md
content: # Test Cases Prompt

> Copy and paste this prompt into any AI chat window to generate test cases for the AI Company Framework skill.

---

## Prompt

```
You are generating test cases for the AI Company Framework skill.

Department: Framework & Infrastructure
Skill: AI Company Framework

Generate test cases for the following categories:

1. FUNCTIONAL TESTS
   - Core happy path for each responsibility
   - Each workflow step in sequence
   - Each output format validation
   - Each error code trigger

2. EDGE CASES
   - Empty or null inputs
   - Boundary values (min, max, zero)
   - Concurrent operations
   - Network timeout scenarios

3. INTEGRATION TESTS
   - Cross-agent communication via HQ
   - Dependency skill invocation
   - Permission boundary enforcement
   - Audit trail completeness

4. REGRESSION TESTS
   - Known defect scenarios (from version history)
   - Previously fixed issues
   - Breaking change validation

5. PERFORMANCE TESTS
   - Response time under normal load
   - Response time under peak load
   - Memory usage patterns
   - Concurrent user handling

For each test case provide:
- Test ID: TC-AI_COMPANY_FRAMEWORK-NNN
- Description: What is being tested
- Input: Test input data
- Expected Output: What should happen
- Priority: P0/P1/P2/P3
```

---

*Copy-paste ready for any AI chat window. Not intended for automated agent invocation.*


path: prompts/04-documentation.md
content: # Documentation Prompt

> Copy and paste this prompt into any AI chat window to generate documentation for the AI Company Framework skill.

---

## Prompt

```
You are generating documentation for the AI Company Framework skill.

Department: Framework & Infrastructure
Skill: AI Company Framework

Generate the following documentation:

1. README SECTION
   - Skill overview and purpose
   - Quick start guide (3 steps or fewer)
   - Prerequisites and dependencies
   - Configuration options

2. API REFERENCE
   - All input parameters with types and descriptions
   - All output fields with types and descriptions
   - All error codes with meanings and resolutions
   - All trigger keywords with examples

3. ARCHITECTURE DIAGRAM
   - Skill position in department and company
   - Dependency graph with other skills
   - Data flow diagram
   - Permission boundaries

4. USAGE EXAMPLES
   - Common use cases with step-by-step walkthroughs
   - Integration examples with dependency skills
   - Troubleshooting guide for common issues
   - FAQ based on typical questions

5. CHANGELOG
   - Version history with change descriptions
   - Migration guide for major versions
   - Deprecation notices if applicable

Output format: Markdown with proper heading hierarchy.
```

---

*Copy-paste ready for any AI chat window. Not intended for automated agent invocation.*


path: prompts/05-workflow-execution.md
content: # Workflow Execution Prompt

> Copy and paste this prompt into any AI chat window to execute the AI Company Framework skill workflow.

---

## Prompt

```
You are executing the AI Company Framework skill workflow for an AI Company system.

Department: Framework & Infrastructure
Skill: AI Company Framework

Execute the complete workflow:

1. SETUP
   - Verify all dependencies are available
   - Confirm permissions are correctly configured
   - Initialize required resources
   - Load configuration from SKILL.md

2. EXECUTE CORE WORKFLOW
   - Follow each workflow step defined in the skill
   - Validate inputs at each step
   - Process data according to method patterns
   - Generate outputs in specified format

3. QUALITY VERIFICATION
   - Run robustness checks on outputs
   - Verify all constraints are satisfied
   - Confirm error codes are properly handled
   - Validate integration with dependency skills

4. DELIVER RESULTS
   - Format output per skill specification
   - Include audit trail and traceability tags
   - Attach quality metrics and scores
   - Flag any warnings or conditional results

5. CLOSE-LOOP
   - Log execution metrics for KPI tracking
   - Update shared state via HQ
   - Archive execution record for audit
   - Schedule follow-up if needed

Output: Complete execution results with quality metrics and audit trail.
```

---

*Copy-paste ready for any AI chat window. Not intended for automated agent invocation.*


path: references/method-patterns.md
content: # Method Patterns & Detailed Specifications

> Full specifications for AI Company Framework. Merged: Standardization + Modularization + Generalization + Ecosystem + Registry + SkillLearner + Starter.

---

# AI Company Framework Skill v3.0

> Framework & Infrastructure for All-AI-Employee Technology Companies.
> Standards, modularity, generalization, ecosystem, registry, skill learning, starter templates.

---

## 1. Trigger Scenarios

| Category | Trigger Keywords |
|----------|-----------------|
| Standards | "Standard", "Convention", "Naming", "Schema" |
| Modular | "Module", "Component", "Decompose", "Interface" |
| General | "Generalize", "Reuse", "Template", "Pattern" |
| Ecosystem | "Ecosystem", "Integration", "Compatibility", "Interoperability" |
| Registry | "Register", "Agent registry", "Skill registry", "Discovery" |
| Learning | "Skill learning", "Learn skill", "Skill acquisition" |
| Starter | "Starter template", "New project", "Bootstrap", "Quick start" |

---

## 2. Core Identity

- **Position**: AI Company Framework | **Permission Level**: L5 | **ID**: FW-000 | **Reports to**: CTO-001

---

## 3. Core Responsibilities

### 3.1 Standardization

```
Naming Conventions:
  Skills: ai-company-{function} (lowercase, hyphenated)
  Agents: {PREFIX}-{NNN} (uppercase prefix, numeric ID)
  Departments: {function} (lowercase, hyphenated)
  Versions: semver (MAJOR.MINOR.PATCH)
  Files: kebab-case.md, kebab-case.py

Schema Standards (ClawHub v1.0):
  Required Frontmatter:
    name, slug, version, description, license, tags,
    triggers (keywords, patterns),
    interface (inputs, outputs, errors),
    permissions (levels, constraints),
    quality (idempotent, robustness),
    metadata (author, created, updated, department)

  Optional Frontmatter:
    dependencies, conflicts, examples, documentation, changelog

Code Style:
  - English-only for all compiled content
  - Chinese allowed only in trigger keywords for market matching
  - Markdown for documentation (GFM extended)
  - JSON for schemas and configurations
  - YAML for frontmatter only
```

### 3.2 Modularization

```
Modularity Principles:
  - Single Responsibility: Each skill does one thing well
  - Interface Segregation: Minimal interface per consumer
  - Dependency Inversion: Depend on abstractions, not implementations
  - Maximum Dependencies: 5 per skill
  - No Circular Dependencies: DAG dependency graph only

Module Structure:
  Each skill is a self-contained module:
    SKILL.md          - Index and quick reference
    references/       - Detailed specifications
    prompts/          - User-facing prompts
    (No code execution within skill files)

Integration Patterns:
  | Pattern | Description | Use Case |
  |---------|-------------|----------|
  | Request-Response | Synchronous query | Single skill invocation |
  | Event-Driven | Async notification | Cross-skill triggers |
  | Pipeline | Sequential processing | Multi-step workflows |
  | Fan-out | Parallel distribution | Broadcast to multiple skills |
  | Aggregator | Collect and merge | Multi-source data collection |
```

### 3.3 Generalization

```
Generalization Levels:
  | Level | Description | Reuse Potential |
  |-------|-------------|----------------|
  | L1-Company-Specific | Hardcoded for one company | Low (single use) |
  | L2-Domain-Specific | Configurable for domain | Medium (domain reuse) |
  | L3-Industry-Standard | Follows industry patterns | High (industry reuse) |
  | L4-Universal | Applicable across industries | Very High (global reuse) |

  Target: All skills at L3+

Generalization Checklist:
  [ ] No company-specific names or identifiers
  [ ] No hardcoded URLs, paths, or credentials
  [ ] Configurable parameters (not inline values)
  [ ] Template-based generation (not one-off)
  [ ] Documentation uses generic examples
  [ ] Reusable in 3+ contexts without modification

Template System:
  Skill Template: Defines structure for new skills
  Agent Template: Defines structure for new agents
  Prompt Template: Defines structure for new prompts
  All templates version-controlled and ClawHub-published
```

### 3.4 Ecosystem

```
Ecosystem Architecture:
  Core Layer: CEO, COO, HQ, CTO, CISO, CLO, CHO, CFO, CRO, CQO, CMO
  Executive Layer: WRTR, PMGR, ANLT, CSSM, ENGR, QENG, LEGAL, HR
  Translation Layer: TR-COORD, TR-EN, TR-ZH, TR-RU, TR-FR
  Infrastructure Layer: Framework, Harness, Registry, Starter

Interoperability Rules:
  - All inter-skill communication via HQ
  - All skills must declare dependencies explicitly
  - All skills must handle missing dependencies gracefully
  - Version compatibility: semver, MAJOR = breaking change
  - Deprecation: 90-day notice before removal

Ecosystem Health:
  | Metric | Target |
  |--------|--------|
  | Dependency resolution rate | 100% |
  | Circular dependency count | 0 |
  | Deprecated skill usage | 0 |
  | Version compatibility | 100% |
```

### 3.5 Registry

```
Agent Registry:
  | Field | Type | Required |
  |-------|------|----------|
  | agent_id | string | Yes |
  | name | string | Yes |
  | department | string | Yes |
  | permission_level | L1-L5 | Yes |
  | skills | list | Yes |
  | dependencies | list | Yes |
  | status | enum | Yes |
  | created_at | timestamp | Yes |
  | updated_at | timestamp | Yes |

Skill Registry:
  | Field | Type | Required |
  |-------|------|----------|
  | slug | string | Yes |
  | name | string | Yes |
  | version | semver | Yes |
  | department | string | Yes |
  | dependencies | list | Yes |
  | clawhub_id | string | Yes |
  | quality_score | number | No |
  | last_reviewed | timestamp | No |

Discovery:
  - Skills discoverable by: keyword, department, capability
  - Agents discoverable by: department, capability, availability
  - Auto-suggest based on task description
```

### 3.6 Skill Learning (from SkillLearner)

```
Skill Acquisition Pipeline:
  1. IDENTIFY: Determine skill gap from CHO assessment or task failure
  2. SEARCH: Search ClawHub for matching skills
  3. EVALUATE: Assess skill quality (CQO gates G0-G7)
  4. INSTALL: Download and integrate skill
  5. CONFIGURE: Map skill to agent, set permissions
  6. TEST: Validate skill in sandbox
  7. ACTIVATE: Enable skill for production use
  8. MONITOR: Track skill effectiveness

Learning Priorities:
  | Priority | Source | Example |
  |----------|--------|---------|
  | P0 | Task failure | Agent cannot complete assigned task |
  | P1 | CHO assessment | Skills gap identified in review |
  | P2 | Strategic plan | New capability needed for OKR |
  | P3 | Market opportunity | CMO discovers new demand signal |
```

### 3.7 Starter Templates

```
Quick Start:
  1. Install: clawhub install ai-company-starter
  2. Initialize: Configure company name, departments, agents
  3. Deploy: Activate core C-Suite agents
  4. Customize: Add domain-specific skills
  5. Launch: Begin operations

Starter Includes:
  - Core C-Suite skills (CEO, COO, CFO, CTO, CISO, CLO, CHO, CMO, CRO, CQO)
  - HQ routing and state management
  - Default permission levels
  - Standard SOPs and templates
  - Sample OKRs and dashboards

Customization Points:
  - Department structure
  - Agent configurations
  - Permission policies
  - SLA tiers and targets
  - Brand voice and style guide
```

---

## 4. Error Codes

| Code | Meaning | Resolution |
|------|---------|------------|
| FW_E001 | Schema validation failed | Fix frontmatter, re-validate |
| FW_E002 | Circular dependency detected | Break cycle, restructure |
| FW_E003 | Generalization level too low | Refactor for reusability |
| FW_E004 | Registry entry missing | Register agent/skill |
| FW_E005 | Skill installation failed | Check compatibility, retry |
| FW_E006 | Template rendering failed | Fix template variables |
| FW_E007 | Ecosystem compatibility issue | Version check, update |
| FW_E008 | Starter initialization failed | Check prerequisites, retry |

---

## 5. Constraints & Metrics

Constraints: All skills L3+ generalization; No circular dependencies; All agents registered; ClawHub Schema v1.0 mandatory; 90-day deprecation notice required.

| Metric | Target |
|--------|--------|
| Schema compliance | 100% |
| Generalization level | L3+ for all |
| Circular dependencies | 0 |
| Registry completeness | 100% |
| Skill learning success rate | >90% |
| Starter setup time | <30min |

*Enhanced by AI-Company Skills Rebuilder v3.0*


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)