skillstore-cli 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +95 -0
- package/data/bundles/devflow-complete.json +19 -0
- package/data/free-skills/devflow-agile/manifest.json +19 -0
- package/data/free-skills/devflow-agile/plugin/commands/agile/retro.md +23 -0
- package/data/free-skills/devflow-agile/plugin/commands/agile/review.md +21 -0
- package/data/free-skills/devflow-agile/plugin/commands/agile/sprint.md +30 -0
- package/data/free-skills/devflow-agile/plugin/commands/agile/standup.md +20 -0
- package/data/free-skills/devflow-agile/plugin/commands/agile.md +35 -0
- package/data/free-skills/devflow-agile/plugin/commands/devflow.md +42 -0
- package/data/free-skills/devflow-agile/plugin/skills/developer/SKILL.md +93 -0
- package/data/free-skills/devflow-agile/plugin/skills/developer/assets/sample-output.md +182 -0
- package/data/free-skills/devflow-agile/plugin/skills/developer/references/clean-architecture.md +361 -0
- package/data/free-skills/devflow-agile/plugin/skills/developer/references/clean-code-guide.md +207 -0
- package/data/free-skills/devflow-agile/plugin/skills/developer/references/debugging-methodology.md +191 -0
- package/data/free-skills/devflow-agile/template/agents/agile-coach.md +76 -0
- package/data/free-skills/devflow-agile/template/workflows/agile-sprint-workflow.md +81 -0
- package/data/free-skills/devflow-bootstrap/manifest.json +8 -0
- package/data/free-skills/devflow-bootstrap/plugin/commands/bootstrap/auto.md +31 -0
- package/data/free-skills/devflow-bootstrap/plugin/commands/bootstrap.md +38 -0
- package/data/free-skills/devflow-bootstrap/plugin/commands/devflow.md +20 -0
- package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/SKILL.md +56 -0
- package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/assets/sample-output.md +216 -0
- package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/references/architecture-decisions.md +254 -0
- package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/references/stack-templates.md +400 -0
- package/data/free-skills/devflow-bootstrap/template/agents/bootstrap-specialist.md +56 -0
- package/data/free-skills/devflow-bootstrap/template/workflows/bootstrap-workflow.md +70 -0
- package/data/free-skills/devflow-docs/manifest.json +8 -0
- package/data/free-skills/devflow-docs/plugin/commands/devflow.md +20 -0
- package/data/free-skills/devflow-docs/plugin/commands/docs/generate.md +17 -0
- package/data/free-skills/devflow-docs/plugin/commands/docs/parse.md +19 -0
- package/data/free-skills/devflow-docs/plugin/commands/docs.md +26 -0
- package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/SKILL.md +59 -0
- package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/assets/sample-output.md +114 -0
- package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/references/extraction-techniques.md +115 -0
- package/data/free-skills/devflow-docs/plugin/skills/pdf-processor/references/ocr-strategies.md +167 -0
- package/data/free-skills/devflow-docs/template/agents/docs-specialist.md +35 -0
- package/data/free-skills/devflow-docs/template/workflows/docs-workflow.md +70 -0
- package/data/free-skills/devflow-postproject/manifest.json +13 -0
- package/data/free-skills/devflow-postproject/plugin/commands/devflow.md +34 -0
- package/data/free-skills/devflow-postproject/plugin/commands/postproject/handover.md +21 -0
- package/data/free-skills/devflow-postproject/plugin/commands/postproject/retro.md +21 -0
- package/data/free-skills/devflow-postproject/plugin/commands/postproject/support.md +21 -0
- package/data/free-skills/devflow-postproject/plugin/commands/postproject.md +32 -0
- package/data/free-skills/devflow-postproject/plugin/skills/retrospective/SKILL.md +70 -0
- package/data/free-skills/devflow-postproject/plugin/skills/retrospective/assets/sample-output.md +79 -0
- package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/facilitation-techniques.md +178 -0
- package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/lessons-learned-template.md +118 -0
- package/data/free-skills/devflow-postproject/plugin/skills/retrospective/references/retro-techniques.md +100 -0
- package/data/free-skills/devflow-postproject/template/agents/transition-manager.md +71 -0
- package/data/free-skills/devflow-postproject/template/workflows/transition-workflow.md +72 -0
- package/data/free-skills/devflow-presale/manifest.json +15 -0
- package/data/free-skills/devflow-presale/plugin/commands/devflow.md +47 -0
- package/data/free-skills/devflow-presale/plugin/commands/presale/analyze.md +30 -0
- package/data/free-skills/devflow-presale/plugin/commands/presale/estimate.md +30 -0
- package/data/free-skills/devflow-presale/plugin/commands/presale/price.md +30 -0
- package/data/free-skills/devflow-presale/plugin/commands/presale/propose.md +30 -0
- package/data/free-skills/devflow-presale/plugin/commands/presale.md +42 -0
- package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/SKILL.md +63 -0
- package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/assets/sample-output.md +129 -0
- package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/references/extraction-framework.md +140 -0
- package/data/free-skills/devflow-presale/plugin/skills/requirement-analysis/references/output-template.md +132 -0
- package/data/free-skills/devflow-presale/template/agents/presale-lead.md +83 -0
- package/data/free-skills/devflow-presale/template/agents/proposal-reviewer.md +63 -0
- package/data/free-skills/devflow-presale/template/workflows/presale-workflow.md +70 -0
- package/data/registry/categories.json +7 -0
- package/data/registry/packages.json +184 -0
- package/data/shared/framework/agents/brainstormer.md +74 -0
- package/data/shared/framework/agents/code-reviewer.md +87 -0
- package/data/shared/framework/agents/debugger.md +84 -0
- package/data/shared/framework/agents/docs-manager.md +55 -0
- package/data/shared/framework/agents/git-manager.md +59 -0
- package/data/shared/framework/agents/planner.md +68 -0
- package/data/shared/framework/agents/researcher.md +66 -0
- package/data/shared/framework/agents/tester.md +65 -0
- package/data/shared/framework/commands/cook/auto.md +27 -0
- package/data/shared/framework/commands/cook.md +45 -0
- package/data/shared/framework/commands/fix/ci.md +21 -0
- package/data/shared/framework/commands/fix/test.md +26 -0
- package/data/shared/framework/commands/fix/types.md +29 -0
- package/data/shared/framework/commands/fix.md +26 -0
- package/data/shared/framework/commands/git/cm.md +37 -0
- package/data/shared/framework/commands/git/pr.md +40 -0
- package/data/shared/framework/config/CLAUDE.md.template +26 -0
- package/data/shared/framework/config/settings.json +41 -0
- package/data/shared/framework/config/skillstore.config.json +29 -0
- package/data/shared/framework/hooks/discord-notify.sh +85 -0
- package/data/shared/framework/hooks/docs-sync.sh +53 -0
- package/data/shared/framework/hooks/modularization-hook.js +103 -0
- package/data/shared/framework/hooks/notification.js +94 -0
- package/data/shared/framework/hooks/quality-gate.js +109 -0
- package/data/shared/framework/hooks/scout-block.js +77 -0
- package/data/shared/framework/hooks/telegram-notify.sh +77 -0
- package/data/shared/framework/protocols/error-recovery.md +80 -0
- package/data/shared/framework/protocols/orchestration-protocol.md +112 -0
- package/data/shared/framework/quality/review-protocol.md +76 -0
- package/data/shared/framework/quality/verification-protocol.md +66 -0
- package/data/shared/framework/rules/development-rules.md +75 -0
- package/data/shared/framework/skills/backend-development/SKILL.md +77 -0
- package/data/shared/framework/skills/backend-development/assets/sample-output.md +175 -0
- package/data/shared/framework/skills/backend-development/references/advanced-patterns.md +180 -0
- package/data/shared/framework/skills/backend-development/references/api-design-guide.md +160 -0
- package/data/shared/framework/skills/backend-development/references/architecture-patterns.md +183 -0
- package/data/shared/framework/skills/backend-development/references/observability-resilience.md +155 -0
- package/data/shared/framework/skills/backend-development/references/troubleshooting.md +199 -0
- package/data/shared/framework/skills/codebase-analysis/SKILL.md +72 -0
- package/data/shared/framework/skills/codebase-analysis/assets/sample-output.md +263 -0
- package/data/shared/framework/skills/codebase-analysis/references/analysis-techniques.md +241 -0
- package/data/shared/framework/skills/codebase-analysis/references/dependency-mapping.md +280 -0
- package/data/shared/framework/skills/codebase-analysis/references/tech-debt-assessment.md +208 -0
- package/data/shared/framework/skills/databases/SKILL.md +72 -0
- package/data/shared/framework/skills/databases/assets/sample-output.md +212 -0
- package/data/shared/framework/skills/databases/references/advanced-data-patterns.md +259 -0
- package/data/shared/framework/skills/databases/references/query-optimization.md +214 -0
- package/data/shared/framework/skills/databases/references/schema-design.md +159 -0
- package/data/shared/framework/skills/databases/references/troubleshooting.md +214 -0
- package/data/shared/framework/skills/debugging-investigation/SKILL.md +84 -0
- package/data/shared/framework/skills/debugging-investigation/assets/sample-output.md +314 -0
- package/data/shared/framework/skills/debugging-investigation/references/systematic-debugging.md +197 -0
- package/data/shared/framework/skills/debugging-investigation/references/tool-specific-guides.md +202 -0
- package/data/shared/framework/skills/debugging-investigation/references/troubleshooting-patterns.md +196 -0
- package/data/shared/framework/skills/frontend-development/SKILL.md +67 -0
- package/data/shared/framework/skills/frontend-development/assets/sample-output.md +110 -0
- package/data/shared/framework/skills/frontend-development/references/component-patterns.md +112 -0
- package/data/shared/framework/skills/frontend-development/references/performance-guide.md +169 -0
- package/data/shared/framework/skills/frontend-development/references/routing-forms-realtime.md +374 -0
- package/data/shared/framework/skills/frontend-development/references/ssr-rsc-patterns.md +284 -0
- package/data/shared/framework/skills/frontend-development/references/troubleshooting.md +154 -0
- package/data/shared/framework/skills/mobile-development/SKILL.md +67 -0
- package/data/shared/framework/skills/mobile-development/assets/sample-output.md +382 -0
- package/data/shared/framework/skills/mobile-development/references/mobile-patterns.md +681 -0
- package/data/shared/framework/skills/mobile-development/references/mobile-performance.md +524 -0
- package/data/shared/framework/skills/mobile-development/references/troubleshooting.md +158 -0
- package/data/shared/framework/skills/security-audit/SKILL.md +83 -0
- package/data/shared/framework/skills/security-audit/assets/sample-output.md +451 -0
- package/data/shared/framework/skills/security-audit/references/owasp-checklist.md +580 -0
- package/data/shared/framework/skills/security-audit/references/secure-coding-patterns.md +433 -0
- package/data/shared/framework/skills/security-audit/references/vulnerability-remediation.md +331 -0
- package/data/shared/framework/skills/ui-generation/SKILL.md +70 -0
- package/data/shared/framework/skills/ui-generation/assets/sample-output.md +139 -0
- package/data/shared/framework/skills/ui-generation/references/accessibility-responsive.md +127 -0
- package/data/shared/framework/skills/ui-generation/references/compound-components.md +252 -0
- package/data/shared/framework/skills/ui-generation/references/generation-patterns.md +110 -0
- package/data/shared/framework/skills/ui-generation/references/storybook-design-system.md +278 -0
- package/data/shared/framework/skills/ui-generation/references/troubleshooting.md +198 -0
- package/data/shared/framework/workflows/documentation-management.md +58 -0
- package/data/shared/framework/workflows/primary-workflow.md +88 -0
- package/dist/commands/activate.d.ts +3 -0
- package/dist/commands/activate.d.ts.map +1 -0
- package/dist/commands/activate.js +34 -0
- package/dist/commands/activate.js.map +1 -0
- package/dist/commands/bundle.d.ts +3 -0
- package/dist/commands/bundle.d.ts.map +1 -0
- package/dist/commands/bundle.js +64 -0
- package/dist/commands/bundle.js.map +1 -0
- package/dist/commands/install.d.ts +3 -0
- package/dist/commands/install.d.ts.map +1 -0
- package/dist/commands/install.js +99 -0
- package/dist/commands/install.js.map +1 -0
- package/dist/commands/list.d.ts +3 -0
- package/dist/commands/list.d.ts.map +1 -0
- package/dist/commands/list.js +37 -0
- package/dist/commands/list.js.map +1 -0
- package/dist/commands/search.d.ts +3 -0
- package/dist/commands/search.d.ts.map +1 -0
- package/dist/commands/search.js +30 -0
- package/dist/commands/search.js.map +1 -0
- package/dist/commands/status.d.ts +3 -0
- package/dist/commands/status.d.ts.map +1 -0
- package/dist/commands/status.js +35 -0
- package/dist/commands/status.js.map +1 -0
- package/dist/commands/update.d.ts +3 -0
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/update.js +68 -0
- package/dist/commands/update.js.map +1 -0
- package/dist/download/cache.d.ts +3 -0
- package/dist/download/cache.d.ts.map +1 -0
- package/dist/download/cache.js +18 -0
- package/dist/download/cache.js.map +1 -0
- package/dist/download/client.d.ts +2 -0
- package/dist/download/client.d.ts.map +1 -0
- package/dist/download/client.js +58 -0
- package/dist/download/client.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/installer/file-copier.d.ts +6 -0
- package/dist/installer/file-copier.d.ts.map +1 -0
- package/dist/installer/file-copier.js +32 -0
- package/dist/installer/file-copier.js.map +1 -0
- package/dist/installer/plugin-installer.d.ts +12 -0
- package/dist/installer/plugin-installer.d.ts.map +1 -0
- package/dist/installer/plugin-installer.js +33 -0
- package/dist/installer/plugin-installer.js.map +1 -0
- package/dist/installer/template-installer.d.ts +12 -0
- package/dist/installer/template-installer.d.ts.map +1 -0
- package/dist/installer/template-installer.js +45 -0
- package/dist/installer/template-installer.js.map +1 -0
- package/dist/license/crypto.d.ts +16 -0
- package/dist/license/crypto.d.ts.map +1 -0
- package/dist/license/crypto.js +50 -0
- package/dist/license/crypto.js.map +1 -0
- package/dist/license/license-store.d.ts +19 -0
- package/dist/license/license-store.d.ts.map +1 -0
- package/dist/license/license-store.js +99 -0
- package/dist/license/license-store.js.map +1 -0
- package/dist/license/validator.d.ts +32 -0
- package/dist/license/validator.d.ts.map +1 -0
- package/dist/license/validator.js +81 -0
- package/dist/license/validator.js.map +1 -0
- package/dist/registry/loader.d.ts +30 -0
- package/dist/registry/loader.d.ts.map +1 -0
- package/dist/registry/loader.js +22 -0
- package/dist/registry/loader.js.map +1 -0
- package/dist/registry/search-engine.d.ts +9 -0
- package/dist/registry/search-engine.d.ts.map +1 -0
- package/dist/registry/search-engine.js +30 -0
- package/dist/registry/search-engine.js.map +1 -0
- package/dist/utils/config.d.ts +14 -0
- package/dist/utils/config.d.ts.map +1 -0
- package/dist/utils/config.js +28 -0
- package/dist/utils/config.js.map +1 -0
- package/dist/utils/logger.d.ts +9 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +22 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/utils/paths.d.ts +20 -0
- package/dist/utils/paths.d.ts.map +1 -0
- package/dist/utils/paths.js +79 -0
- package/dist/utils/paths.js.map +1 -0
- package/package.json +54 -0
|
@@ -0,0 +1,400 @@
|
|
|
1
|
+
# Stack Templates
|
|
2
|
+
|
|
3
|
+
## Next.js (App Router)
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
project-root/
|
|
7
|
+
├── src/
|
|
8
|
+
│ ├── app/
|
|
9
|
+
│ │ ├── layout.tsx
|
|
10
|
+
│ │ ├── page.tsx
|
|
11
|
+
│ │ ├── globals.css
|
|
12
|
+
│ │ ├── (auth)/
|
|
13
|
+
│ │ │ ├── login/page.tsx
|
|
14
|
+
│ │ │ └── register/page.tsx
|
|
15
|
+
│ │ └── api/
|
|
16
|
+
│ │ └── health/route.ts
|
|
17
|
+
│ ├── components/
|
|
18
|
+
│ │ ├── ui/ # Reusable UI components (Button, Input, Modal...)
|
|
19
|
+
│ │ ├── layout/ # Header, Footer, Sidebar, Navigation
|
|
20
|
+
│ │ └── features/ # Feature-specific components
|
|
21
|
+
│ ├── lib/
|
|
22
|
+
│ │ ├── utils.ts
|
|
23
|
+
│ │ ├── constants.ts
|
|
24
|
+
│ │ └── validations.ts
|
|
25
|
+
│ ├── hooks/
|
|
26
|
+
│ │ └── index.ts
|
|
27
|
+
│ ├── services/ # API client, external service integrations
|
|
28
|
+
│ │ └── api.ts
|
|
29
|
+
│ ├── stores/ # State management (Zustand/Jotai)
|
|
30
|
+
│ │ └── index.ts
|
|
31
|
+
│ └── types/
|
|
32
|
+
│ └── index.ts
|
|
33
|
+
├── public/
|
|
34
|
+
│ └── assets/
|
|
35
|
+
├── tests/
|
|
36
|
+
│ ├── unit/
|
|
37
|
+
│ └── e2e/
|
|
38
|
+
├── next.config.ts
|
|
39
|
+
├── tsconfig.json
|
|
40
|
+
├── tailwind.config.ts
|
|
41
|
+
├── postcss.config.mjs
|
|
42
|
+
├── package.json
|
|
43
|
+
├── .env.example
|
|
44
|
+
├── .gitignore
|
|
45
|
+
└── README.md
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**Key configs:**
|
|
49
|
+
- `tsconfig.json`: strict mode, path aliases (`@/*` → `src/*`)
|
|
50
|
+
- `tailwind.config.ts`: content paths, custom theme extensions
|
|
51
|
+
- `next.config.ts`: image domains, redirects, env exposure
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## NestJS
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
project-root/
|
|
59
|
+
├── src/
|
|
60
|
+
│ ├── main.ts
|
|
61
|
+
│ ├── app.module.ts
|
|
62
|
+
│ ├── app.controller.ts
|
|
63
|
+
│ ├── app.service.ts
|
|
64
|
+
│ ├── common/
|
|
65
|
+
│ │ ├── decorators/
|
|
66
|
+
│ │ ├── filters/
|
|
67
|
+
│ │ │ └── http-exception.filter.ts
|
|
68
|
+
│ │ ├── guards/
|
|
69
|
+
│ │ │ └── auth.guard.ts
|
|
70
|
+
│ │ ├── interceptors/
|
|
71
|
+
│ │ │ └── logging.interceptor.ts
|
|
72
|
+
│ │ ├── middleware/
|
|
73
|
+
│ │ ├── pipes/
|
|
74
|
+
│ │ │ └── validation.pipe.ts
|
|
75
|
+
│ │ └── interfaces/
|
|
76
|
+
│ ├── config/
|
|
77
|
+
│ │ ├── configuration.ts
|
|
78
|
+
│ │ └── validation.ts
|
|
79
|
+
│ ├── modules/
|
|
80
|
+
│ │ ├── auth/
|
|
81
|
+
│ │ │ ├── auth.module.ts
|
|
82
|
+
│ │ │ ├── auth.controller.ts
|
|
83
|
+
│ │ │ ├── auth.service.ts
|
|
84
|
+
│ │ │ ├── dto/
|
|
85
|
+
│ │ │ ├── guards/
|
|
86
|
+
│ │ │ └── strategies/
|
|
87
|
+
│ │ └── users/
|
|
88
|
+
│ │ ├── users.module.ts
|
|
89
|
+
│ │ ├── users.controller.ts
|
|
90
|
+
│ │ ├── users.service.ts
|
|
91
|
+
│ │ ├── dto/
|
|
92
|
+
│ │ ├── entities/
|
|
93
|
+
│ │ └── users.repository.ts
|
|
94
|
+
│ └── database/
|
|
95
|
+
│ ├── database.module.ts
|
|
96
|
+
│ └── migrations/
|
|
97
|
+
├── test/
|
|
98
|
+
│ ├── app.e2e-spec.ts
|
|
99
|
+
│ └── jest-e2e.json
|
|
100
|
+
├── nest-cli.json
|
|
101
|
+
├── tsconfig.json
|
|
102
|
+
├── tsconfig.build.json
|
|
103
|
+
├── package.json
|
|
104
|
+
├── .env.example
|
|
105
|
+
├── .gitignore
|
|
106
|
+
└── README.md
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
**Key configs:**
|
|
110
|
+
- `nest-cli.json`: compiler options, asset handling
|
|
111
|
+
- `tsconfig.json`: decorator metadata, strict mode
|
|
112
|
+
- Validation via `class-validator` + `class-transformer`
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Spring Boot
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
project-root/
|
|
120
|
+
├── src/
|
|
121
|
+
│ ├── main/
|
|
122
|
+
│ │ ├── java/com/example/project/
|
|
123
|
+
│ │ │ ├── Application.java
|
|
124
|
+
│ │ │ ├── config/
|
|
125
|
+
│ │ │ │ ├── SecurityConfig.java
|
|
126
|
+
│ │ │ │ └── WebConfig.java
|
|
127
|
+
│ │ │ ├── controller/
|
|
128
|
+
│ │ │ │ └── HealthController.java
|
|
129
|
+
│ │ │ ├── service/
|
|
130
|
+
│ │ │ │ └── impl/
|
|
131
|
+
│ │ │ ├── repository/
|
|
132
|
+
│ │ │ ├── model/
|
|
133
|
+
│ │ │ │ ├── entity/
|
|
134
|
+
│ │ │ │ ├── dto/
|
|
135
|
+
│ │ │ │ └── mapper/
|
|
136
|
+
│ │ │ ├── exception/
|
|
137
|
+
│ │ │ │ ├── GlobalExceptionHandler.java
|
|
138
|
+
│ │ │ │ └── ResourceNotFoundException.java
|
|
139
|
+
│ │ │ └── util/
|
|
140
|
+
│ │ └── resources/
|
|
141
|
+
│ │ ├── application.yml
|
|
142
|
+
│ │ ├── application-dev.yml
|
|
143
|
+
│ │ ├── application-staging.yml
|
|
144
|
+
│ │ ├── application-prod.yml
|
|
145
|
+
│ │ └── db/migration/ # Flyway migrations
|
|
146
|
+
│ └── test/
|
|
147
|
+
│ └── java/com/example/project/
|
|
148
|
+
│ ├── controller/
|
|
149
|
+
│ └── service/
|
|
150
|
+
├── pom.xml # or build.gradle.kts
|
|
151
|
+
├── .env.example
|
|
152
|
+
├── .gitignore
|
|
153
|
+
├── Dockerfile
|
|
154
|
+
└── README.md
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
**Key configs:**
|
|
158
|
+
- Maven: `pom.xml` with Spring Boot parent, dependencies (Web, JPA, Security, Validation)
|
|
159
|
+
- Gradle: `build.gradle.kts` with plugins, dependencies
|
|
160
|
+
- Profile-based config: `application-{env}.yml`
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Express + TypeScript
|
|
165
|
+
|
|
166
|
+
```
|
|
167
|
+
project-root/
|
|
168
|
+
├── src/
|
|
169
|
+
│ ├── index.ts
|
|
170
|
+
│ ├── app.ts
|
|
171
|
+
│ ├── config/
|
|
172
|
+
│ │ ├── index.ts
|
|
173
|
+
│ │ └── database.ts
|
|
174
|
+
│ ├── routes/
|
|
175
|
+
│ │ ├── index.ts
|
|
176
|
+
│ │ └── health.route.ts
|
|
177
|
+
│ ├── controllers/
|
|
178
|
+
│ │ └── health.controller.ts
|
|
179
|
+
│ ├── services/
|
|
180
|
+
│ ├── models/
|
|
181
|
+
│ ├── middleware/
|
|
182
|
+
│ │ ├── error-handler.ts
|
|
183
|
+
│ │ ├── auth.ts
|
|
184
|
+
│ │ ├── validation.ts
|
|
185
|
+
│ │ └── logger.ts
|
|
186
|
+
│ ├── utils/
|
|
187
|
+
│ │ └── logger.ts
|
|
188
|
+
│ └── types/
|
|
189
|
+
│ └── index.ts
|
|
190
|
+
├── tests/
|
|
191
|
+
│ ├── unit/
|
|
192
|
+
│ └── integration/
|
|
193
|
+
├── tsconfig.json
|
|
194
|
+
├── package.json
|
|
195
|
+
├── .env.example
|
|
196
|
+
├── .gitignore
|
|
197
|
+
├── Dockerfile
|
|
198
|
+
└── README.md
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
**Key configs:**
|
|
202
|
+
- `tsconfig.json`: outDir, rootDir, strict, path aliases
|
|
203
|
+
- Express setup: CORS, helmet, compression, rate limiting
|
|
204
|
+
- Error handling: centralized error handler middleware
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
## React + Vite
|
|
209
|
+
|
|
210
|
+
```
|
|
211
|
+
project-root/
|
|
212
|
+
├── src/
|
|
213
|
+
│ ├── main.tsx
|
|
214
|
+
│ ├── App.tsx
|
|
215
|
+
│ ├── components/
|
|
216
|
+
│ │ ├── ui/
|
|
217
|
+
│ │ ├── layout/
|
|
218
|
+
│ │ └── features/
|
|
219
|
+
│ ├── pages/
|
|
220
|
+
│ ├── hooks/
|
|
221
|
+
│ ├── stores/ # Zustand / Redux Toolkit
|
|
222
|
+
│ ├── services/
|
|
223
|
+
│ │ └── api.ts
|
|
224
|
+
│ ├── utils/
|
|
225
|
+
│ ├── types/
|
|
226
|
+
│ ├── styles/
|
|
227
|
+
│ │ └── globals.css
|
|
228
|
+
│ └── assets/
|
|
229
|
+
├── public/
|
|
230
|
+
├── tests/
|
|
231
|
+
│ ├── unit/
|
|
232
|
+
│ └── e2e/
|
|
233
|
+
├── vite.config.ts
|
|
234
|
+
├── tsconfig.json
|
|
235
|
+
├── tsconfig.node.json
|
|
236
|
+
├── index.html
|
|
237
|
+
├── package.json
|
|
238
|
+
├── .env.example
|
|
239
|
+
├── .gitignore
|
|
240
|
+
└── README.md
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
**Key configs:**
|
|
244
|
+
- `vite.config.ts`: plugins (react), resolve aliases, proxy
|
|
245
|
+
- `tsconfig.json`: JSX, path aliases, strict
|
|
246
|
+
- Test setup: Vitest + React Testing Library
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
## Python FastAPI
|
|
251
|
+
|
|
252
|
+
```
|
|
253
|
+
project-root/
|
|
254
|
+
├── app/
|
|
255
|
+
│ ├── __init__.py
|
|
256
|
+
│ ├── main.py
|
|
257
|
+
│ ├── config.py
|
|
258
|
+
│ ├── dependencies.py
|
|
259
|
+
│ ├── routers/
|
|
260
|
+
│ │ ├── __init__.py
|
|
261
|
+
│ │ └── health.py
|
|
262
|
+
│ ├── models/
|
|
263
|
+
│ │ ├── __init__.py
|
|
264
|
+
│ │ └── base.py
|
|
265
|
+
│ ├── schemas/
|
|
266
|
+
│ │ └── __init__.py
|
|
267
|
+
│ ├── services/
|
|
268
|
+
│ │ └── __init__.py
|
|
269
|
+
│ ├── repositories/
|
|
270
|
+
│ │ └── __init__.py
|
|
271
|
+
│ └── utils/
|
|
272
|
+
│ └── __init__.py
|
|
273
|
+
├── tests/
|
|
274
|
+
│ ├── conftest.py
|
|
275
|
+
│ ├── test_health.py
|
|
276
|
+
│ └── factories/
|
|
277
|
+
├── alembic/
|
|
278
|
+
│ ├── env.py
|
|
279
|
+
│ └── versions/
|
|
280
|
+
├── alembic.ini
|
|
281
|
+
├── pyproject.toml
|
|
282
|
+
├── requirements.txt
|
|
283
|
+
├── .env.example
|
|
284
|
+
├── .gitignore
|
|
285
|
+
├── Dockerfile
|
|
286
|
+
└── README.md
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
**Key configs:**
|
|
290
|
+
- `pyproject.toml`: project metadata, dependencies, tool configs (ruff, mypy, pytest)
|
|
291
|
+
- Alembic for database migrations
|
|
292
|
+
- Pydantic settings for config management
|
|
293
|
+
|
|
294
|
+
---
|
|
295
|
+
|
|
296
|
+
## Flutter
|
|
297
|
+
|
|
298
|
+
```
|
|
299
|
+
project-root/
|
|
300
|
+
├── lib/
|
|
301
|
+
│ ├── main.dart
|
|
302
|
+
│ ├── app.dart
|
|
303
|
+
│ ├── core/
|
|
304
|
+
│ │ ├── constants/
|
|
305
|
+
│ │ ├── theme/
|
|
306
|
+
│ │ ├── utils/
|
|
307
|
+
│ │ └── network/
|
|
308
|
+
│ │ └── api_client.dart
|
|
309
|
+
│ ├── features/
|
|
310
|
+
│ │ ├── auth/
|
|
311
|
+
│ │ │ ├── data/
|
|
312
|
+
│ │ │ ├── domain/
|
|
313
|
+
│ │ │ └── presentation/
|
|
314
|
+
│ │ └── home/
|
|
315
|
+
│ │ ├── data/
|
|
316
|
+
│ │ ├── domain/
|
|
317
|
+
│ │ └── presentation/
|
|
318
|
+
│ ├── models/
|
|
319
|
+
│ ├── services/
|
|
320
|
+
│ └── widgets/ # Shared widgets
|
|
321
|
+
├── test/
|
|
322
|
+
│ ├── unit/
|
|
323
|
+
│ ├── widget/
|
|
324
|
+
│ └── integration/
|
|
325
|
+
├── assets/
|
|
326
|
+
│ ├── images/
|
|
327
|
+
│ ├── fonts/
|
|
328
|
+
│ └── icons/
|
|
329
|
+
├── pubspec.yaml
|
|
330
|
+
├── analysis_options.yaml
|
|
331
|
+
├── .env.example
|
|
332
|
+
├── .gitignore
|
|
333
|
+
└── README.md
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
**Key configs:**
|
|
337
|
+
- `pubspec.yaml`: dependencies (riverpod/bloc, dio, freezed, go_router)
|
|
338
|
+
- `analysis_options.yaml`: strict lint rules
|
|
339
|
+
- Feature-based architecture (clean architecture pattern)
|
|
340
|
+
|
|
341
|
+
---
|
|
342
|
+
|
|
343
|
+
## Monorepo (Turborepo / Nx)
|
|
344
|
+
|
|
345
|
+
```
|
|
346
|
+
project-root/
|
|
347
|
+
├── apps/
|
|
348
|
+
│ ├── web/ # Next.js or React app
|
|
349
|
+
│ ├── api/ # NestJS or Express backend
|
|
350
|
+
│ ├── mobile/ # React Native or Flutter
|
|
351
|
+
│ └── admin/ # Admin dashboard
|
|
352
|
+
├── packages/
|
|
353
|
+
│ ├── ui/ # Shared UI component library
|
|
354
|
+
│ ├── config-eslint/ # Shared ESLint config
|
|
355
|
+
│ ├── config-typescript/ # Shared TypeScript config
|
|
356
|
+
│ ├── utils/ # Shared utilities
|
|
357
|
+
│ └── types/ # Shared type definitions
|
|
358
|
+
├── turbo.json # or nx.json
|
|
359
|
+
├── package.json # Root workspace config
|
|
360
|
+
├── pnpm-workspace.yaml # or npm/yarn workspaces
|
|
361
|
+
├── tsconfig.base.json
|
|
362
|
+
├── .env.example
|
|
363
|
+
├── .gitignore
|
|
364
|
+
├── Dockerfile
|
|
365
|
+
└── README.md
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
**Key configs:**
|
|
369
|
+
- `turbo.json`: pipeline definitions (build, lint, test, dev)
|
|
370
|
+
- Root `package.json`: workspace definition, shared scripts
|
|
371
|
+
- Shared configs: ESLint, TypeScript, Prettier inherited by all packages
|
|
372
|
+
|
|
373
|
+
---
|
|
374
|
+
|
|
375
|
+
## Common Files (All Stacks)
|
|
376
|
+
|
|
377
|
+
### .gitignore
|
|
378
|
+
- Node: `node_modules/`, `.next/`, `dist/`, `.env`, `.env.local`
|
|
379
|
+
- Python: `__pycache__/`, `.venv/`, `*.pyc`, `.env`
|
|
380
|
+
- Java: `target/`, `build/`, `.gradle/`, `*.class`
|
|
381
|
+
- General: `.DS_Store`, `*.log`, `.idea/`, `.vscode/` (except shared settings)
|
|
382
|
+
|
|
383
|
+
### README.md Template
|
|
384
|
+
- Project name + description
|
|
385
|
+
- Prerequisites
|
|
386
|
+
- Getting started (install, setup env, run dev)
|
|
387
|
+
- Available scripts/commands
|
|
388
|
+
- Project structure overview
|
|
389
|
+
- Contributing guidelines link
|
|
390
|
+
|
|
391
|
+
### .env.example
|
|
392
|
+
- All required environment variables with placeholder values
|
|
393
|
+
- Grouped by category (App, Database, Auth, External Services)
|
|
394
|
+
- Comments explaining each variable
|
|
395
|
+
|
|
396
|
+
### docker-compose.yml
|
|
397
|
+
- App service (with Dockerfile)
|
|
398
|
+
- Database service (PostgreSQL/MySQL/MongoDB)
|
|
399
|
+
- Cache service (Redis) if needed
|
|
400
|
+
- Network and volume definitions
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bootstrap-specialist
|
|
3
|
+
description: Use this agent to orchestrate Sprint 0 project setup — scaffolding, CI/CD, environment configuration, and code standards. Coordinates all bootstrap skills for end-to-end project initialization.
|
|
4
|
+
tools: Glob, Grep, LS, Read, Edit, Write, Bash
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
You are a DevOps & Project Setup Specialist with deep expertise in modern development toolchains. You turn project requirements into fully configured, CI/CD-ready codebases.
|
|
8
|
+
|
|
9
|
+
## Core Responsibilities
|
|
10
|
+
|
|
11
|
+
### 1. Project Scaffolding
|
|
12
|
+
- Activate `project-scaffold` skill
|
|
13
|
+
- Generate directory structure and boilerplate for selected tech stack
|
|
14
|
+
- Configure package manager, path aliases, module resolution
|
|
15
|
+
- Create README, .gitignore, .env.example
|
|
16
|
+
|
|
17
|
+
### 2. CI/CD Pipeline Setup
|
|
18
|
+
- Activate `cicd-setup` skill
|
|
19
|
+
- Generate workflow files for target platform (GitHub Actions, GitLab CI, Jenkins)
|
|
20
|
+
- Configure stages: lint → test → build → deploy
|
|
21
|
+
- Set up environment-specific deployments (preview, staging, production)
|
|
22
|
+
|
|
23
|
+
### 3. Environment Configuration
|
|
24
|
+
- Activate `env-configurator` skill
|
|
25
|
+
- Generate .env templates for each environment
|
|
26
|
+
- Configure Docker Compose for local development
|
|
27
|
+
- Set up environment variable validation
|
|
28
|
+
|
|
29
|
+
### 4. Code Standards
|
|
30
|
+
- Activate `code-standards-init` skill
|
|
31
|
+
- Install and configure linters, formatters, git hooks
|
|
32
|
+
- Set up conventional commit enforcement
|
|
33
|
+
- Configure editor settings
|
|
34
|
+
|
|
35
|
+
## Execution Order
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
1. project-scaffold (foundation)
|
|
39
|
+
2. code-standards-init (quality tooling on top of scaffold)
|
|
40
|
+
3. env-configurator (environment setup)
|
|
41
|
+
4. cicd-setup (pipeline references the project structure)
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Steps 2 and 3 can run in parallel after step 1.
|
|
45
|
+
|
|
46
|
+
## Error Recovery
|
|
47
|
+
- If tech stack ambiguous: ask user to confirm before scaffolding
|
|
48
|
+
- If package install fails: retry once, then report with error log
|
|
49
|
+
- If config conflicts detected: report both options, let user decide
|
|
50
|
+
- Max retries: 2 per skill activation
|
|
51
|
+
|
|
52
|
+
## Checkpoint Protocol
|
|
53
|
+
After completing each skill activation:
|
|
54
|
+
1. Save generated files list
|
|
55
|
+
2. Log: skill name, files created, warnings encountered
|
|
56
|
+
3. If interrupted: resume from last completed skill
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Bootstrap Workflow
|
|
2
|
+
|
|
3
|
+
End-to-end Sprint 0 project setup from tech stack decision to production-ready codebase.
|
|
4
|
+
|
|
5
|
+
## Phase 1: Discovery
|
|
6
|
+
|
|
7
|
+
1. **Requirements Gathering**
|
|
8
|
+
- Identify tech stack (language, framework, database)
|
|
9
|
+
- Determine deployment target (Vercel, AWS, GCP, self-hosted)
|
|
10
|
+
- List integrations needed (auth, payments, email, analytics)
|
|
11
|
+
- Define team size and branching strategy
|
|
12
|
+
|
|
13
|
+
2. **Stack Validation**
|
|
14
|
+
- `bootstrap-specialist` validates compatibility of chosen technologies
|
|
15
|
+
- Flag potential conflicts (e.g., incompatible library versions)
|
|
16
|
+
- Confirm monorepo vs single-project structure
|
|
17
|
+
- Output: Validated tech stack document
|
|
18
|
+
|
|
19
|
+
## Phase 2: Foundation
|
|
20
|
+
|
|
21
|
+
3. **Project Scaffolding**
|
|
22
|
+
- `bootstrap-specialist` activates `project-scaffold` skill
|
|
23
|
+
- Generate directory structure from stack template
|
|
24
|
+
- Create boilerplate files (entry points, configs, types)
|
|
25
|
+
- Output: Project structure with README and .gitignore
|
|
26
|
+
|
|
27
|
+
4. **Code Standards** (parallel with step 5)
|
|
28
|
+
- `bootstrap-specialist` activates `code-standards-init` skill
|
|
29
|
+
- Install linter, formatter, git hooks
|
|
30
|
+
- Configure commit message enforcement
|
|
31
|
+
- Output: Quality tooling configured and verified
|
|
32
|
+
|
|
33
|
+
5. **Environment Setup** (parallel with step 4)
|
|
34
|
+
- `bootstrap-specialist` activates `env-configurator` skill
|
|
35
|
+
- Generate .env templates per environment
|
|
36
|
+
- Configure Docker Compose for local development
|
|
37
|
+
- Set up environment variable validation
|
|
38
|
+
- Output: Environment configs and Docker setup
|
|
39
|
+
|
|
40
|
+
## Phase 3: Pipeline
|
|
41
|
+
|
|
42
|
+
6. **CI/CD Configuration**
|
|
43
|
+
- `bootstrap-specialist` activates `cicd-setup` skill
|
|
44
|
+
- Input: Project structure from phase 2
|
|
45
|
+
- Generate workflow files (lint → test → build → deploy)
|
|
46
|
+
- Configure environment-specific deployments
|
|
47
|
+
- Output: CI/CD pipeline files
|
|
48
|
+
|
|
49
|
+
## Phase 4: Verification
|
|
50
|
+
|
|
51
|
+
7. **End-to-End Check**
|
|
52
|
+
- Verify all config files have valid syntax
|
|
53
|
+
- Run linter to confirm zero errors on clean project
|
|
54
|
+
- Run formatter to confirm no changes needed
|
|
55
|
+
- Verify git hooks execute correctly
|
|
56
|
+
- Confirm CI workflow is syntactically valid
|
|
57
|
+
- Output: Verification report
|
|
58
|
+
|
|
59
|
+
8. **Handoff**
|
|
60
|
+
- Present generated file tree to user
|
|
61
|
+
- List required secrets and environment variables
|
|
62
|
+
- Provide getting-started instructions
|
|
63
|
+
- Suggest first sprint backlog items
|
|
64
|
+
|
|
65
|
+
## Quality Gates
|
|
66
|
+
|
|
67
|
+
- **After Phase 1**: Tech stack confirmed by user
|
|
68
|
+
- **After Phase 2**: `pnpm lint` and `pnpm format:check` pass with zero errors
|
|
69
|
+
- **After Phase 3**: CI workflow validated (YAML syntax + logical correctness)
|
|
70
|
+
- **After Phase 4**: User confirms setup meets requirements
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@skillstore/devflow-docs",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"skills": ["pdf-processor", "excel-analyzer", "doc-generator", "presentation-reviewer"],
|
|
5
|
+
"freeSkills": ["pdf-processor"],
|
|
6
|
+
"commands": ["docs", "docs/parse", "docs/generate"],
|
|
7
|
+
"modes": ["plugin", "template"]
|
|
8
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: DevFlow smart router — automatically routes to the right DevFlow package
|
|
3
|
+
argument-hint: [task description]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Smart Routing
|
|
7
|
+
|
|
8
|
+
<task>
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
</task>
|
|
11
|
+
|
|
12
|
+
Analyze the task and route to the appropriate DevFlow command:
|
|
13
|
+
|
|
14
|
+
| Keywords/Context | Route To |
|
|
15
|
+
|------------------|----------|
|
|
16
|
+
| PDF, Excel, document, parse, generate report, PowerPoint | `/docs` |
|
|
17
|
+
| presale, RFP, proposal, estimate, pricing | `/presale` |
|
|
18
|
+
| sprint, standup, agile, backlog, scrum | `/agile` |
|
|
19
|
+
| handover, maintenance, retrospective, post-project | `/postproject` |
|
|
20
|
+
| scaffold, setup, init, Sprint 0, CI/CD, environment | `/bootstrap` |
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Generate a professional document from data or analysis
|
|
3
|
+
argument-hint: [document type and content/data]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Your Mission
|
|
7
|
+
|
|
8
|
+
<input>
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
</input>
|
|
11
|
+
|
|
12
|
+
## Process
|
|
13
|
+
1. Activate `doc-generator` skill
|
|
14
|
+
2. Identify document type (report, proposal, handover, status)
|
|
15
|
+
3. Select appropriate template
|
|
16
|
+
4. Assemble content from provided data
|
|
17
|
+
5. Format and output complete document
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Parse and extract content from a document (PDF, Excel, PowerPoint)
|
|
3
|
+
argument-hint: [file path or paste content]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Your Mission
|
|
7
|
+
|
|
8
|
+
<input>
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
</input>
|
|
11
|
+
|
|
12
|
+
## Process
|
|
13
|
+
1. Identify document type (PDF, Excel, PowerPoint, Word)
|
|
14
|
+
2. Route to appropriate skill:
|
|
15
|
+
- PDF → `pdf-processor`
|
|
16
|
+
- Excel/CSV → `excel-analyzer`
|
|
17
|
+
- PowerPoint → `presentation-reviewer`
|
|
18
|
+
3. Extract structured content
|
|
19
|
+
4. Output in clean Markdown format
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Document processing — parse, analyze, and generate documents
|
|
3
|
+
argument-hint: [task or file reference]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## Your Mission
|
|
7
|
+
|
|
8
|
+
<task>
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
</task>
|
|
11
|
+
|
|
12
|
+
## Smart Routing
|
|
13
|
+
|
|
14
|
+
| Keywords/Patterns | Route To |
|
|
15
|
+
|-------------------|----------|
|
|
16
|
+
| PDF, RFP, contract, spec (read) | `pdf-processor` skill |
|
|
17
|
+
| Excel, CSV, budget, resource plan, data | `excel-analyzer` skill |
|
|
18
|
+
| Generate, create, report, template (write) | `doc-generator` skill |
|
|
19
|
+
| PowerPoint, slides, presentation, deck | `presentation-reviewer` skill |
|
|
20
|
+
|
|
21
|
+
## Sub-commands
|
|
22
|
+
- `/docs:parse [file]` — Extract content from any document type
|
|
23
|
+
- `/docs:generate [template]` — Generate document from data/analysis
|
|
24
|
+
|
|
25
|
+
## References
|
|
26
|
+
- `protocols/error-recovery.md` for failure handling
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# PDF Processor
|
|
2
|
+
|
|
3
|
+
Process PDF documents: extract text, tables, forms, images. Use for RFP analysis, contract review, spec extraction.
|
|
4
|
+
|
|
5
|
+
## Triggers
|
|
6
|
+
|
|
7
|
+
- Received PDF from client
|
|
8
|
+
- Need to extract requirements from RFP
|
|
9
|
+
- Contract review
|
|
10
|
+
- Spec analysis
|
|
11
|
+
- Any PDF document that needs structured data extraction
|
|
12
|
+
|
|
13
|
+
## Process
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
Document Assessment → Content Extraction → Structure Recognition → Data Transformation → Output
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Step 1: Document Assessment
|
|
20
|
+
- Determine PDF type: native text vs scanned (image-based)
|
|
21
|
+
- Check page count and document structure
|
|
22
|
+
- Identify language(s) used
|
|
23
|
+
- Assess quality (resolution, readability)
|
|
24
|
+
|
|
25
|
+
### Step 2: Content Extraction
|
|
26
|
+
- Extract raw text using appropriate method (native text extraction or OCR)
|
|
27
|
+
- Identify and extract tables
|
|
28
|
+
- Extract form fields and their values
|
|
29
|
+
- Extract embedded images and diagrams
|
|
30
|
+
- Pull metadata (author, creation date, version, title)
|
|
31
|
+
|
|
32
|
+
### Step 3: Structure Recognition
|
|
33
|
+
- Detect document sections (headings, subheadings)
|
|
34
|
+
- Map table of contents to content
|
|
35
|
+
- Identify lists, bullet points, numbered items
|
|
36
|
+
- Recognize header/footer patterns
|
|
37
|
+
- Detect multi-column layouts
|
|
38
|
+
|
|
39
|
+
### Step 4: Data Transformation
|
|
40
|
+
- Convert tables to structured format (Markdown tables or JSON)
|
|
41
|
+
- Organize extracted text by sections
|
|
42
|
+
- Link images/diagrams to relevant sections
|
|
43
|
+
- Normalize data formats (dates, currency, percentages)
|
|
44
|
+
|
|
45
|
+
### Step 5: Output
|
|
46
|
+
- Deliver extracted content in clean Markdown
|
|
47
|
+
- Include confidence scores for OCR-based extractions
|
|
48
|
+
- Flag sections with low extraction quality
|
|
49
|
+
- Provide summary of document structure
|
|
50
|
+
|
|
51
|
+
## References
|
|
52
|
+
- `references/extraction-techniques.md` — Detailed extraction strategies
|
|
53
|
+
- `assets/sample-output.md` — Example extraction output
|
|
54
|
+
|
|
55
|
+
## Notes
|
|
56
|
+
- For scanned PDFs, extraction quality depends on scan resolution
|
|
57
|
+
- Multi-language documents may require language detection per section
|
|
58
|
+
- Always validate table extraction against visual layout
|
|
59
|
+
- Large PDFs (100+ pages): process in chunks, report progress
|