# Org Research Folder Creator

> Use when organisation research is needed and folder structures, projects, and issues should be automatically created based on the research findings. This agent researches companies, creates organisation-knowledge documentation, and auto-generates the corresponding project/issue structures following Paperclip standards.

- Skill: `construct-ai-primary/org-research-folder-creator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/org-research-folder-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/org-research-folder-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/construct-ai-primary/org-research-folder-creator

---


# Org Research Folder Creator - Automated Organisation Research & Documentation Specialist

## Overview

Org Research Folder Creator specializes in AI-powered organisation research, automated folder structure creation, and intelligent project/issue generation. When given a company or organisation to research, this agent:

1. **Researches** the organisation (web search, public records, industry databases)
2. **Creates** comprehensive organisation-knowledge documentation
3. **Auto-generates** the standard folder structure for `organisation-knowledge/{slug}/`
4. **Creates** related projects and issues in the appropriate discipline directories

## When to Use

- When research on a company or organisation is needed
- When organisation-knowledge documentation should be created automatically
- When folder structures need to be auto-generated based on research
- When projects and issues should be created from research findings
- When a new client/vendor/partner needs documentation in the Paperclip ecosystem
- **Don't use when:** Simple folder creation without research (use file creation tools), or when manual control is preferred

## Core Procedures

### Phase 1: Organisation Research

1. **Company Identification**
   - Extract company name, aliases, and branding
   - Identify industry sector and business type
   - Locate headquarters and operational regions

2. **Web Research**
   - Search for official website, LinkedIn, company registrations
   - Find industry databases, news articles, press releases
   - Identify key personnel and ownership structure

3. **Market Analysis**
   - Identify target market and customer segments
   - Analyze competitive positioning
   - Determine geographic footprint

4. **Capability Assessment**
   - Identify core services and products
   - Assess scale and capacity
   - Document key differentiators

### Phase 2: Organisation-Knowledge Documentation

Creates the following structure in `docs-paperclip/organisation-knowledge/{slug}/`:

```
{slug}/
├── COMPANY.md                              ← Main company definition (AgentCompanies v1 schema)
├── knowledge/
│   ├── industry-context/
│   │   ├── company-profile.md            ← Detailed company profile
│   │   ├── market-analysis.md            ← Target market and positioning
│   │   └── competitor-analysis.md         ← Competitive landscape
│   └── workflows/
│       ├── core-workflows.md              ← Primary operational workflows
│       └── ai-agents-suitability.md       ← Recommended AI agents
└── projects/
    ├── {SECTOR-1}/                       ← Project category (grouped by sector)
    │   └── PROJECT.md                    ← Project definition
    ├── {SECTOR-2}/
    │   └── PROJECT.md
    └── ...
```

### Phase 3: Project & Issue Auto-Generation

Based on research findings, creates projects and issues in relevant discipline directories:

1. **Discipline Matching**
   - Match organisation to relevant disciplines (e.g., traffic-signals for Zama Traffic Signals)
   - Identify cross-disciplinary aspects

2. **Project Creation**
   - Create discipline-specific project folders
   - Generate project.md with organisation context

3. **Issue Generation**
   - Generate issues based on identified workflows and opportunities
   - Follow standard issue naming conventions
   - Include organisation context in issue descriptions

### Phase 4: Integration with Existing Structures

For organisations like Zama Traffic Signals that relate to existing disciplines:

1. **Cross-Reference Creation**
   - Link organisation-knowledge to relevant discipline knowledge
   - Create bidirectional references

2. **Workflow Mapping**
   - Map organisation workflows to discipline workflows
   - Identify automation opportunities

3. **Agent Assignment**
   - Recommend appropriate agents for organisation engagement
   - Create agent-specific knowledge bases

## Folder Structure Template

### Organisation-Knowledge Root

```markdown
docs-paperclip/organisation-knowledge/{slug}/
├── COMPANY.md                    # AgentCompanies v1 schema definition
└── knowledge/
    ├── industry-context/         # Business context documentation
    │   ├── company-profile.md
    │   ├── market-analysis.md
    │   └── competitor-analysis.md
    └── workflows/                # Operational workflows
        ├── core-workflows.md
        └── ai-agents-suitability.md
```

### Standard COMPANY.md Frontmatter

```yaml
---
name: {Company Name}
description: {Brief description}
slug: {url-safe-slug}
schema: agentcompanies/v1
version: 1.0.0
license: MIT
authors:
  - name: Paperclip Research
    date: {YYYY-MM-DD}
homepage: {website-url}
tags:
  - {industry-tag}
  - {business-type-tag}
  - {region-tag}
goals:
  - {primary-goal-1}
  - {primary-goal-2}
includes:
  - ./knowledge/industry-context/company-profile.md
  - ./knowledge/industry-context/market-analysis.md
  - ./knowledge/industry-context/competitor-analysis.md
  - ./knowledge/workflows/core-workflows.md
  - ./knowledge/workflows/ai-agents-suitability.md
requirements:
  secrets:
    - OPENROUTER_API_KEY
---
```

## Cross-Discipline Integration

### Traffic Signals Discipline Example (Zama Traffic Signals)

When researching organisations in the traffic-signals space:

1. **Create Organisation Knowledge** in `docs-paperclip/organisation-knowledge/zama/`
2. **Link to Discipline** via `docs-paperclip/disciplines-sector-specific-details/00002-traffic-signals/`
3. **Create Projects** in `disciplines-sector-specific-details/00002-traffic-signals/projects/`
4. **Generate Issues** based on identified opportunities

### Integration Points

| Research Finding | Auto-Generated Structure |
|-----------------|------------------------|
| Company profile | `organisation-knowledge/{slug}/knowledge/industry-context/company-profile.md` |
| Market analysis | `organisation-knowledge/{slug}/knowledge/industry-context/market-analysis.md` |
| Competitors | `organisation-knowledge/{slug}/knowledge/industry-context/competitor-analysis.md` |
| Core workflows | `organisation-knowledge/{slug}/knowledge/workflows/core-workflows.md` |
| AI agents | `organisation-knowledge/{slug}/knowledge/workflows/ai-agents-suitability.md` |
| Discipline match | `disciplines-sector-specific-details/{discipline}/projects/{PROJECT}/` |
| Opportunities | `disciplines-sector-specific-details/{discipline}/projects/{PROJECT}/issues/` |

## Agent Assignment

**Primary Agent:** org-research-folder-creator
**Company:** PaperclipForge AI
**Role:** Automated Organisation Research & Documentation Specialist
**Reports To:** Operations Director
**Backup Agents:** issue-generator, workflow-automator, knowledge-integrator

## Success Metrics

- Research completeness: ≥90% of key information captured
- Folder structure accuracy: 100% compliance with templates
- Cross-reference accuracy: ≥95% links functional
- Issue generation quality: ≥85% issues approved without modification
- Processing speed: <2 hours for standard organisation research

## Error Handling

- **Error:** Research sources unavailable
  **Response:** Use cached data and flag for manual verification
- **Error:** Folder creation fails
  **Response:** Log error, create partial structure, notify operator
- **Error:** Discipline matching unclear
  **Response:** Create in `organisation-knowledge/` only, flag for manual classification

## Cross-Team Integration

**Gigabrain Tags:** paperclipforge, org-research, folder-creation, auto-generation, documentation
**OpenStinger Context:** Organisation research continuity, folder structure knowledge
**PARA Classification:** Organisation knowledge, automated documentation, project generation
**Related Skills:** issue-generator, workflow-automator, knowledge-integrator, assignment-specialist
**Last Updated:** 2026-04-20