@ai-coders/context 0.6.1 → 0.7.0

package/dist/generators/shared/structures/documentation/onboarding.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onboardingStructure = void 0;
+exports.onboardingStructure = {
+    fileType: 'doc',
+    documentName: 'onboarding',
+    title: 'Onboarding Guide',
+    description: 'Complete guide for getting new team members productive, including access setup and first contributions',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Onboarding Guide',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Welcome message and high-level overview of the onboarding process.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Day 1: Access & Accounts',
+            order: 2,
+            contentType: 'checklist',
+            guidance: 'Checklist for Day 1 access setup including email, chat, code repository, issue tracking, and documentation access.',
+            exampleContent: '- [ ] Email account - Verify access to team email\n- [ ] Chat/Communication - Join Slack/Teams and relevant channels\n- [ ] Code repository - GitHub access and SSH key configured\n- [ ] Issue tracking - Jira/GitHub Issues access\n- [ ] Documentation - Wiki/Confluence access',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Day 1-2: Development Environment',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Step-by-step development environment setup with code blocks for installation and configuration commands.',
+            exampleContent: '- Install required software (Node.js, npm, Git, IDE)\n- Clone repository with example bash commands\n- Configure environment variables (.env file)\n- Run database migrations if applicable\n- Verify setup with test commands',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Day 2-3: Project Understanding',
+            order: 4,
+            contentType: 'list',
+            guidance: 'Reading list of core documentation and activities for understanding the codebase, team structure, and responsibilities.',
+            exampleContent: '- [ ] Read core documentation (Project Overview, Architecture, Development Workflow, Testing Strategy)\n- [ ] Explore project structure and main entry points\n- [ ] Meet team members and understand roles\n- [ ] Review recent pull requests for code standards',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Week 1: First Contributions',
+            order: 5,
+            contentType: 'list',
+            guidance: 'Guidance for making first code contributions, learning workflow, and setting up productivity tools.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Required Access & Permissions',
+            order: 6,
+            contentType: 'list',
+            guidance: 'List of accounts, access levels, and permissions needed for different roles (repository, deployments, databases, cloud resources).',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Team Communication',
+            order: 7,
+            contentType: 'list',
+            guidance: 'Document chat channels, recurring meetings, and communication guidelines.',
+            exampleContent: '- **Channels:** #engineering, #team-name, #deployments, #incidents\n- **Meetings:** Daily standup, Sprint planning, Retrospective, Team sync\n- **Guidelines:** Use threads, mention directly when needed, default to public channels',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Learning Resources',
+            order: 8,
+            contentType: 'list',
+            guidance: 'Links to project-specific documentation, technical skill resources, company handbooks, and external resources.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Getting Help',
+            order: 9,
+            contentType: 'prose',
+            guidance: 'Escalation steps when stuck: self-debug, search resources, ask onboarding buddy, ask team channel, ask broader engineering.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Team Culture & Expectations',
+            order: 10,
+            contentType: 'prose',
+            guidance: 'Work hours, code review expectations, development principles, and growth opportunities.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['development-workflow.md', 'project-overview.md', 'architecture.md'],
+};
+//# sourceMappingURL=onboarding.js.map

package/dist/generators/shared/structures/documentation/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/onboarding.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAsB;IACpD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,YAAY;IAC1B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,wGAAwG;IACrH,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oEAAoE;YAC9E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,oHAAoH;YAC9H,cAAc,EAAE,oRAAoR;YACpS,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,kCAAkC;YAC3C,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,0GAA0G;YACpH,cAAc,EAAE,gOAAgO;YAChP,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,yHAAyH;YACnI,cAAc,EAAE,mQAAmQ;YACnR,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,qGAAqG;YAC/G,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,+BAA+B;YACxC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,oIAAoI;YAC9I,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2EAA2E;YACrF,cAAc,EAAE,uOAAuO;YACvP,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,gHAAgH;YAC1H,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,6HAA6H;YACvI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yFAAyF;YACnG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,EAAE,qBAAqB,EAAE,iBAAiB,CAAC;CAC9E,CAAC"}

package/dist/generators/shared/structures/documentation/projectOverview.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const projectOverviewStructure: ScaffoldStructure;
+//# sourceMappingURL=projectOverview.d.ts.map

package/dist/generators/shared/structures/documentation/projectOverview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectOverview.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/projectOverview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA8GtC,CAAC"}

package/dist/generators/shared/structures/documentation/projectOverview.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectOverviewStructure = void 0;
+exports.projectOverviewStructure = {
+    fileType: 'doc',
+    documentName: 'project-overview',
+    title: 'Project Overview',
+    description: 'High-level overview of the project, its purpose, and key components',
+    tone: 'conversational',
+    audience: 'mixed',
+    sections: [
+        {
+            heading: 'Project Overview',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Summarize in 2-3 sentences what problem this project solves and who benefits from it. Focus on the value proposition.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Codebase Reference',
+            order: 2,
+            contentType: 'prose',
+            guidance: 'Add a callout pointing to codebase-map.json for detailed symbol counts, architecture layers, and dependencies. Do NOT list all symbols inline.',
+            exampleContent: '> **Detailed Analysis**: For complete symbol counts, architecture layers, and dependency graphs, see [`codebase-map.json`](./codebase-map.json).',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Quick Facts',
+            order: 3,
+            contentType: 'list',
+            guidance: 'List root directory path, primary languages (with file counts), and key entry points. Reference codebase-map.json for full analysis.',
+            exampleContent: '- Root: `/path/to/repo`\n- Languages: TypeScript (150 files), Python (20 files)\n- Entry: `src/index.ts`\n- Full analysis: [`codebase-map.json`](./codebase-map.json)',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Entry Points',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List main entry points with links (CLI, server, library exports). Use markdown links with line numbers.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Key Exports',
+            order: 5,
+            contentType: 'list',
+            guidance: 'Reference codebase-map.json for the complete list.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'File Structure & Code Organization',
+            order: 6,
+            contentType: 'list',
+            guidance: 'List top-level directories with brief descriptions of their purpose.',
+            exampleContent: '- `src/` — TypeScript source files and CLI entrypoints.\n- `tests/` — Automated tests and fixtures.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Technology Stack Summary',
+            order: 7,
+            contentType: 'prose',
+            guidance: 'Outline primary runtimes, languages, and platforms in use. Note build tooling, linting, and formatting infrastructure.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Core Framework Stack',
+            order: 8,
+            contentType: 'prose',
+            guidance: 'Document core frameworks per layer (backend, frontend, data, messaging). Mention architectural patterns enforced by these frameworks.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'UI & Interaction Libraries',
+            order: 9,
+            contentType: 'prose',
+            guidance: 'List UI kits, CLI interaction helpers, or design system dependencies. Note theming, accessibility, or localization considerations.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Development Tools Overview',
+            order: 10,
+            contentType: 'prose',
+            guidance: 'Highlight essential CLIs, scripts, or developer environments. Link to Tooling guide for deeper setup.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Getting Started Checklist',
+            order: 11,
+            contentType: 'checklist',
+            guidance: 'Provide numbered steps to get a new developer productive. Include install, run, and verify steps.',
+            exampleContent: '1. Install dependencies with `npm install`.\n2. Explore the CLI by running `npm run dev`.\n3. Review Development Workflow for day-to-day tasks.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Next Steps',
+            order: 12,
+            contentType: 'prose',
+            guidance: 'Capture product positioning, key stakeholders, and links to external documentation or product specs.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['architecture.md', 'development-workflow.md', 'tooling.md', 'codebase-map.json'],
+};
+//# sourceMappingURL=projectOverview.js.map

package/dist/generators/shared/structures/documentation/projectOverview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectOverview.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/projectOverview.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,kBAAkB;IAChC,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,qEAAqE;IAClF,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uHAAuH;YACjI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,gJAAgJ;YAC1J,cAAc,EAAE,kJAAkJ;YAClK,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,sIAAsI;YAChJ,cAAc,EAAE,uKAAuK;YACvL,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,yGAAyG;YACnH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,oDAAoD;YAC9D,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oCAAoC;YAC7C,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,sEAAsE;YAChF,cAAc,EAAE,qGAAqG;YACrH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,wHAAwH;YAClI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,sBAAsB;YAC/B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uIAAuI;YACjJ,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,4BAA4B;YACrC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oIAAoI;YAC9I,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,4BAA4B;YACrC,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,mGAAmG;YAC7G,cAAc,EAAE,iJAAiJ;YACjK,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,sGAAsG;YAChH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,iBAAiB,EAAE,yBAAyB,EAAE,YAAY,EAAE,mBAAmB,CAAC;CAC1F,CAAC"}

package/dist/generators/shared/structures/documentation/security.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const securityStructure: ScaffoldStructure;
+//# sourceMappingURL=security.d.ts.map

package/dist/generators/shared/structures/documentation/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAkD/B,CAAC"}

package/dist/generators/shared/structures/documentation/security.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.securityStructure = void 0;
+exports.securityStructure = {
+    fileType: 'doc',
+    documentName: 'security',
+    title: 'Security & Compliance Notes',
+    description: 'Security policies, authentication, secrets management, and compliance requirements',
+    tone: 'formal',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Security & Compliance Notes',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Capture the policies and guardrails that keep this project secure and compliant.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Authentication & Authorization',
+            order: 2,
+            contentType: 'prose',
+            guidance: 'Describe identity providers, token formats, session strategies, and role/permission models.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Secrets & Sensitive Data',
+            order: 3,
+            contentType: 'prose',
+            guidance: 'Document storage locations (vaults, parameter stores), rotation cadence, encryption practices, and data classifications.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Compliance & Policies',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List applicable standards (GDPR, SOC2, HIPAA, internal policies) and evidence requirements.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Incident Response',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Note on-call contacts, escalation steps, and tooling for detection, triage, and post-incident analysis.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['architecture.md'],
+};
+//# sourceMappingURL=security.js.map

package/dist/generators/shared/structures/documentation/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/security.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,UAAU;IACxB,KAAK,EAAE,6BAA6B;IACpC,WAAW,EAAE,oFAAoF;IACjG,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,kFAAkF;YAC5F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,0HAA0H;YACpI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yGAAyG;YACnH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC"}

package/dist/generators/shared/structures/documentation/testing.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const testingStrategyStructure: ScaffoldStructure;
+//# sourceMappingURL=testing.d.ts.map

package/dist/generators/shared/structures/documentation/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAoDtC,CAAC"}

package/dist/generators/shared/structures/documentation/testing.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testingStrategyStructure = void 0;
+exports.testingStrategyStructure = {
+    fileType: 'doc',
+    documentName: 'testing-strategy',
+    title: 'Testing Strategy',
+    description: 'Test frameworks, patterns, coverage requirements, and quality gates',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Testing Strategy',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Document how quality is maintained across the codebase.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Test Types',
+            order: 2,
+            contentType: 'list',
+            guidance: 'For Unit, Integration, and E2E tests: list frameworks, file naming conventions, and required tooling.',
+            exampleContent: '- **Unit**: Jest, files named `*.test.ts`\n- **Integration**: Describe scenarios\n- **E2E**: Note harnesses or environments',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Running Tests',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Commands for running all tests, watch mode, and coverage. Use code blocks.',
+            exampleContent: '- All tests: `npm run test`\n- Watch mode: `npm run test -- --watch`\n- Coverage: `npm run test -- --coverage`',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Quality Gates',
+            order: 4,
+            contentType: 'list',
+            guidance: 'Define minimum coverage expectations. Capture linting or formatting requirements before merging.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Troubleshooting',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Document flaky suites, long-running tests, or environment quirks.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['development-workflow.md'],
+};
+//# sourceMappingURL=testing.js.map

package/dist/generators/shared/structures/documentation/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/testing.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,kBAAkB;IAChC,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,qEAAqE;IAClF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yDAAyD;YACnE,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uGAAuG;YACjH,cAAc,EAAE,6HAA6H;YAC7I,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4EAA4E;YACtF,cAAc,EAAE,gHAAgH;YAChI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,kGAAkG;YAC5G,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,mEAAmE;YAC7E,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}

package/dist/generators/shared/structures/documentation/tooling.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const toolingStructure: ScaffoldStructure;
+//# sourceMappingURL=tooling.d.ts.map

package/dist/generators/shared/structures/documentation/tooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/tooling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,iBAkD9B,CAAC"}

package/dist/generators/shared/structures/documentation/tooling.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolingStructure = void 0;
+exports.toolingStructure = {
+    fileType: 'doc',
+    documentName: 'tooling',
+    title: 'Tooling & Productivity Guide',
+    description: 'Scripts, IDE settings, automation, and developer productivity tips',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Tooling & Productivity Guide',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Collect the scripts, automation, and editor settings that keep contributors efficient.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Required Tooling',
+            order: 2,
+            contentType: 'list',
+            guidance: 'List tools with installation instructions, version requirements, and what they power.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Recommended Automation',
+            order: 3,
+            contentType: 'prose',
+            guidance: 'Document pre-commit hooks, linting/formatting commands, code generators, or scaffolding scripts. Include shortcuts or watch modes.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'IDE / Editor Setup',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List extensions or plugins that catch issues early. Share snippets, templates, or workspace settings.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Productivity Tips',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Document terminal aliases, container workflows, or local emulators. Link to shared scripts or dotfiles.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['development-workflow.md'],
+};
+//# sourceMappingURL=tooling.js.map

package/dist/generators/shared/structures/documentation/tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/tooling.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAsB;IACjD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,SAAS;IACvB,KAAK,EAAE,8BAA8B;IACrC,WAAW,EAAE,oEAAoE;IACjF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,wFAAwF;YAClG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uFAAuF;YACjG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oIAAoI;YAC9I,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yGAAyG;YACnH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}

package/dist/generators/shared/structures/documentation/troubleshooting.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const troubleshootingStructure: ScaffoldStructure;
+//# sourceMappingURL=troubleshooting.d.ts.map

package/dist/generators/shared/structures/documentation/troubleshooting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/troubleshooting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAsFtC,CAAC"}

package/dist/generators/shared/structures/documentation/troubleshooting.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.troubleshootingStructure = void 0;
+exports.troubleshootingStructure = {
+    fileType: 'doc',
+    documentName: 'troubleshooting',
+    title: 'Troubleshooting Guide',
+    description: 'Diagnostic procedures and solutions for common issues, designed for both developers and AI agents',
+    tone: 'technical',
+    audience: 'mixed',
+    sections: [
+        {
+            heading: 'Troubleshooting Guide',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Describe the purpose and agent protocol: run diagnostics, match symptoms to patterns, resolve if confident, escalate if uncertain.',
+            exampleContent: '**Agent Protocol:**\n1. Run diagnostic script to gather facts\n2. Match symptoms to known patterns\n3. Execute resolution if confidence high (>80%)\n4. Escalate to human if uncertain\n5. Log all diagnostic steps',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Agent Diagnostic Script',
+            order: 2,
+            contentType: 'code-block',
+            guidance: 'Provide bash script for agents to diagnose system state including application status, errors, resources, services, and processes.',
+            exampleContent: 'Script that checks: health endpoint, recent errors, CPU/memory/disk usage, database/cache connectivity, recent changes, and processes',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Agent Decision Tree',
+            order: 3,
+            contentType: 'diagram',
+            guidance: 'ASCII or Mermaid diagram showing how agents classify issues based on diagnostic output (not responding, database unreachable, errors, performance).',
+            exampleContent: 'App responding? → DB reachable? → Error log entries? → Resource usage normal?',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Common Issues & Solutions',
+            order: 4,
+            contentType: 'prose',
+            guidance: 'Document common issues organized by category (startup, database, performance) with: error detection patterns, agent diagnostic procedures, auto-resolution scripts, and escalation criteria.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Application Won\'t Start',
+            order: 5,
+            contentType: 'list',
+            guidance: 'List common startup issues (port in use, missing modules, missing environment variables) with bash commands for diagnosis and resolution.',
+            exampleContent: '- Port in use: use lsof to find process, kill it, restart app\n- Missing module: clear node_modules and reinstall\n- Missing env var: check .env.example and set required variables',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Performance Issues',
+            order: 6,
+            contentType: 'prose',
+            guidance: 'Document how to diagnose performance problems (high CPU, memory, slow queries) with monitoring commands and optimization steps.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Database Issues',
+            order: 7,
+            contentType: 'prose',
+            guidance: 'Document database connection diagnostics with connection checking procedures and startup attempts for containerized or local databases.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Escalation Criteria',
+            order: 8,
+            contentType: 'prose',
+            guidance: 'Define when agents must escalate: unknown patterns, data corruption risk, security issues, multiple failed attempts, or human approval needed.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Escalation Format',
+            order: 9,
+            contentType: 'code-block',
+            guidance: 'Provide template for structured escalation including issue description, symptoms, diagnostics run, attempted resolutions, and recommendations.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['development-workflow.md', 'security.md'],
+};
+//# sourceMappingURL=troubleshooting.js.map

package/dist/generators/shared/structures/documentation/troubleshooting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/troubleshooting.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,iBAAiB;IAC/B,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,mGAAmG;IAChH,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oIAAoI;YAC9I,cAAc,EAAE,qNAAqN;YACrO,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,mIAAmI;YAC7I,cAAc,EAAE,uIAAuI;YACvJ,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,SAAS;YACtB,QAAQ,EAAE,qJAAqJ;YAC/J,cAAc,EAAE,+EAA+E;YAC/F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8LAA8L;YACxM,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2IAA2I;YACrJ,cAAc,EAAE,qLAAqL;YACrM,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iIAAiI;YAC3I,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yIAAyI;YACnJ,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,gJAAgJ;YAC1J,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,gJAAgJ;YAC1J,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,EAAE,aAAa,CAAC;CACnD,CAAC"}

package/dist/generators/shared/structures/documentation/workflow.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const developmentWorkflowStructure: ScaffoldStructure;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/generators/shared/structures/documentation/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,4BAA4B,EAAE,iBAmD1C,CAAC"}

package/dist/generators/shared/structures/documentation/workflow.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.developmentWorkflowStructure = void 0;
+exports.developmentWorkflowStructure = {
+    fileType: 'doc',
+    documentName: 'development-workflow',
+    title: 'Development Workflow',
+    description: 'Day-to-day engineering processes, branching, and contribution guidelines',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Development Workflow',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Outline the day-to-day engineering process for this repository.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Branching & Releases',
+            order: 2,
+            contentType: 'list',
+            guidance: 'Describe the branching model (trunk-based, Git Flow, etc.). Note release cadence and tagging conventions.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Local Development',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Commands to install dependencies, run locally, and build for distribution. Use code blocks for commands.',
+            exampleContent: '- Install: `npm install`\n- Run: `npm run dev`\n- Build: `npm run build`',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Code Review Expectations',
+            order: 4,
+            contentType: 'prose',
+            guidance: 'Summarize review checklists and required approvals. Reference AGENTS.md for agent collaboration tips.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Onboarding Tasks',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Point newcomers to first issues or starter tickets. Link to internal runbooks or dashboards.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['testing-strategy.md', 'tooling.md'],
+};
+//# sourceMappingURL=workflow.js.map

package/dist/generators/shared/structures/documentation/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAsB;IAC7D,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,sBAAsB;IACpC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,0EAA0E;IACvF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,sBAAsB;YAC/B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iEAAiE;YAC3E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,sBAAsB;YAC/B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2GAA2G;YACrH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,0GAA0G;YACpH,cAAc,EAAE,0EAA0E;YAC1F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8FAA8F;YACxG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,qBAAqB,EAAE,YAAY,CAAC;CAC9C,CAAC"}

package/dist/generators/shared/structures/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scaffold structures index
+ *
+ * This file serves as the main barrel export for all scaffold structures,
+ * providing backward compatibility with the original scaffoldStructures.ts import path.
+ */
+export * from './types';
+export * from './documentation';
+export * from './agents';
+export * from './skills';
+export * from './plans';
+export * from './registry';
+export * from './validation';
+export * from './serialization';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/shared/structures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}