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

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

---
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

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