claudeos-core 1.0.7 → 1.2.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.
Potentially problematic release.
This version of claudeos-core might be problematic. Click here for more details.
- package/CHANGELOG.md +84 -1
- package/CONTRIBUTING.md +15 -4
- package/README.de.md +187 -11
- package/README.es.md +187 -11
- package/README.fr.md +187 -11
- package/README.hi.md +187 -11
- package/README.ja.md +186 -10
- package/README.ko.md +331 -364
- package/README.md +200 -11
- package/README.ru.md +187 -11
- package/README.vi.md +188 -12
- package/README.zh-CN.md +186 -10
- package/bin/cli.js +183 -61
- package/bootstrap.sh +128 -21
- package/content-validator/index.js +131 -60
- package/health-checker/index.js +29 -23
- package/import-linter/index.js +14 -8
- package/manifest-generator/index.js +26 -20
- package/package.json +84 -75
- package/pass-json-validator/index.js +92 -70
- package/pass-prompts/templates/common/header.md +4 -4
- package/pass-prompts/templates/common/lang-instructions.json +27 -0
- package/pass-prompts/templates/common/pass3-footer.md +2 -3
- package/pass-prompts/templates/java-spring/pass1.md +84 -81
- package/pass-prompts/templates/java-spring/pass2.md +66 -66
- package/pass-prompts/templates/java-spring/pass3.md +60 -60
- package/pass-prompts/templates/kotlin-spring/pass1.md +172 -0
- package/pass-prompts/templates/kotlin-spring/pass2.md +109 -0
- package/pass-prompts/templates/kotlin-spring/pass3.md +98 -0
- package/pass-prompts/templates/node-express/pass1.md +73 -73
- package/pass-prompts/templates/node-express/pass2.md +66 -66
- package/pass-prompts/templates/node-express/pass3.md +53 -53
- package/pass-prompts/templates/node-nextjs/pass1.md +68 -68
- package/pass-prompts/templates/node-nextjs/pass2.md +61 -61
- package/pass-prompts/templates/node-nextjs/pass3.md +48 -48
- package/pass-prompts/templates/python-django/pass1.md +78 -78
- package/pass-prompts/templates/python-django/pass2.md +69 -69
- package/pass-prompts/templates/python-django/pass3.md +45 -45
- package/pass-prompts/templates/python-fastapi/pass1.md +76 -76
- package/pass-prompts/templates/python-fastapi/pass2.md +67 -67
- package/pass-prompts/templates/python-fastapi/pass3.md +45 -45
- package/plan-installer/index.js +623 -97
- package/plan-validator/index.js +54 -23
- package/sync-checker/index.js +25 -14
|
@@ -1,84 +1,84 @@
|
|
|
1
|
-
claudeos-core/generated/
|
|
2
|
-
|
|
1
|
+
Read all pass1-*.json files from the claudeos-core/generated/ directory and
|
|
2
|
+
merge all domain analysis results into a single unified report.
|
|
3
3
|
|
|
4
|
-
|
|
4
|
+
Merge items:
|
|
5
5
|
|
|
6
|
-
1.
|
|
7
|
-
- View
|
|
8
|
-
- Serializer
|
|
9
|
-
- Model
|
|
10
|
-
-
|
|
11
|
-
-
|
|
6
|
+
1. Universal Patterns (shared by 100% of all domains)
|
|
7
|
+
- View style (FBV/CBV/ViewSet, URL patterns, response format)
|
|
8
|
+
- Serializer conventions
|
|
9
|
+
- Model structure (AbstractModel, field rules)
|
|
10
|
+
- Error handling patterns
|
|
11
|
+
- Transaction strategy
|
|
12
12
|
|
|
13
|
-
2.
|
|
14
|
-
-
|
|
13
|
+
2. Majority Patterns (shared by 50%+ of domains)
|
|
14
|
+
- Specify which domains share them
|
|
15
15
|
|
|
16
|
-
3.
|
|
17
|
-
-
|
|
18
|
-
- Celery
|
|
19
|
-
- WebSocket:
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
- Admin
|
|
23
|
-
- Management Command:
|
|
24
|
-
-
|
|
16
|
+
3. Domain-Specific Patterns (unique to a single domain)
|
|
17
|
+
- File upload: which domain
|
|
18
|
+
- Celery tasks: which domain
|
|
19
|
+
- WebSocket: which domain
|
|
20
|
+
- External API: which domain
|
|
21
|
+
- Caching: which domain
|
|
22
|
+
- Admin customization: which domain
|
|
23
|
+
- Management Command: which domain
|
|
24
|
+
- Messaging: which domain
|
|
25
25
|
|
|
26
|
-
4.
|
|
27
|
-
-
|
|
28
|
-
-
|
|
26
|
+
4. Anti-pattern Summary
|
|
27
|
+
- Consolidate all inconsistencies found across domains
|
|
28
|
+
- Classify by severity (CRITICAL / HIGH / MEDIUM / LOW)
|
|
29
29
|
|
|
30
|
-
5.
|
|
31
|
-
-
|
|
32
|
-
- Model/Serializer/View
|
|
33
|
-
- URL
|
|
34
|
-
-
|
|
30
|
+
5. Naming Conventions Summary
|
|
31
|
+
- App/module naming (snake_case)
|
|
32
|
+
- Model/Serializer/View naming
|
|
33
|
+
- URL pattern conventions
|
|
34
|
+
- Test file structure
|
|
35
35
|
|
|
36
|
-
6.
|
|
37
|
-
- Abstract
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
36
|
+
6. Common Models/Utilities List
|
|
37
|
+
- Abstract model fields
|
|
38
|
+
- Shared Manager/QuerySet
|
|
39
|
+
- Utility functions
|
|
40
|
+
- Constants/Enum management
|
|
41
41
|
|
|
42
|
-
7.
|
|
43
|
-
-
|
|
44
|
-
- Permission
|
|
45
|
-
- CORS
|
|
46
|
-
-
|
|
47
|
-
- CSRF
|
|
42
|
+
7. Security/Authentication Patterns
|
|
43
|
+
- Authentication method (JWT, Session, Token, OAuth2)
|
|
44
|
+
- Permission class strategy
|
|
45
|
+
- CORS configuration
|
|
46
|
+
- Environment variable management
|
|
47
|
+
- CSRF policy
|
|
48
48
|
|
|
49
|
-
8.
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
- Fixture
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
49
|
+
8. Database Patterns
|
|
50
|
+
- Table naming (db_table, verbose_name)
|
|
51
|
+
- Migration strategy (squash, revert)
|
|
52
|
+
- Fixture/seed management
|
|
53
|
+
- Audit fields (created_at, updated_at)
|
|
54
|
+
- Index/constraints
|
|
55
|
+
- Soft delete patterns
|
|
56
56
|
|
|
57
|
-
9.
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
- Factory/Fixture
|
|
61
|
-
-
|
|
62
|
-
- DB
|
|
63
|
-
-
|
|
57
|
+
9. Testing Strategy Summary
|
|
58
|
+
- Test coverage level
|
|
59
|
+
- Test classification system (unit/integration/E2E)
|
|
60
|
+
- Factory/Fixture strategy
|
|
61
|
+
- Mocking strategy
|
|
62
|
+
- DB test strategy
|
|
63
|
+
- Test naming conventions
|
|
64
64
|
|
|
65
|
-
10.
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
65
|
+
10. Logging/Monitoring Strategy
|
|
66
|
+
- Logger standard
|
|
67
|
+
- Log level policy
|
|
68
|
+
- Structured logging
|
|
69
|
+
- Request/response logging
|
|
70
70
|
|
|
71
|
-
11.
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
- DB
|
|
71
|
+
11. Performance Patterns
|
|
72
|
+
- Caching strategy
|
|
73
|
+
- Query optimization status (select_related, prefetch_related)
|
|
74
|
+
- Async processing status
|
|
75
|
+
- DB connection management
|
|
76
76
|
|
|
77
|
-
12.
|
|
78
|
-
- Lint/Format
|
|
79
|
-
- Pre-commit
|
|
77
|
+
12. Code Quality Tools
|
|
78
|
+
- Lint/Format tools (ruff, black, isort, flake8, mypy)
|
|
79
|
+
- Pre-commit hooks
|
|
80
80
|
- Type Checking (mypy, pyright)
|
|
81
|
-
- CI
|
|
81
|
+
- CI integration status
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
83
|
+
Do not generate code. Merge only.
|
|
84
|
+
Save results to claudeos-core/generated/pass2-merged.json.
|
|
@@ -1,58 +1,58 @@
|
|
|
1
|
-
claudeos-core/generated/project-analysis.json
|
|
2
|
-
claudeos-core/generated/pass2-merged.json
|
|
3
|
-
|
|
1
|
+
Read claudeos-core/generated/project-analysis.json and
|
|
2
|
+
claudeos-core/generated/pass2-merged.json, then
|
|
3
|
+
generate all ClaudeOS-Core files based on the analysis results.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Do not read the original source code again. Reference only the analysis results.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Generation targets:
|
|
8
8
|
|
|
9
|
-
1. CLAUDE.md (
|
|
10
|
-
- Role
|
|
9
|
+
1. CLAUDE.md (project root)
|
|
10
|
+
- Role definition (based on detected stack)
|
|
11
11
|
- Build & Run Commands (pip/poetry, manage.py, gunicorn/uwsgi)
|
|
12
|
-
-
|
|
13
|
-
- Django
|
|
14
|
-
- Standard/Skills/Guide
|
|
12
|
+
- Core architecture diagram
|
|
13
|
+
- Django app structure
|
|
14
|
+
- Standard/Skills/Guide reference table
|
|
15
15
|
|
|
16
|
-
2. claudeos-core/standard/ (
|
|
17
|
-
- 00.core/01.project-overview.md —
|
|
18
|
-
- 00.core/02.architecture.md — MTV
|
|
19
|
-
- 00.core/03.naming-conventions.md —
|
|
20
|
-
- 10.backend-api/01.view-patterns.md — FBV/CBV/ViewSet
|
|
21
|
-
- 10.backend-api/02.serializer-patterns.md — Serializer
|
|
22
|
-
- 10.backend-api/03.model-patterns.md — Model
|
|
23
|
-
- 10.backend-api/04.response-exception.md —
|
|
24
|
-
- 10.backend-api/05.business-logic.md — Service Layer,
|
|
25
|
-
- 10.backend-api/06.admin-patterns.md — Admin
|
|
16
|
+
2. claudeos-core/standard/ (active domains only)
|
|
17
|
+
- 00.core/01.project-overview.md — Stack, app list, server info
|
|
18
|
+
- 00.core/02.architecture.md — MTV structure, request flow, app structure
|
|
19
|
+
- 00.core/03.naming-conventions.md — App/model/view/serializer naming conventions
|
|
20
|
+
- 10.backend-api/01.view-patterns.md — FBV/CBV/ViewSet patterns + examples
|
|
21
|
+
- 10.backend-api/02.serializer-patterns.md — Serializer writing rules + validation
|
|
22
|
+
- 10.backend-api/03.model-patterns.md — Model structure, Manager, Signal, QuerySet
|
|
23
|
+
- 10.backend-api/04.response-exception.md — Response/error handling patterns
|
|
24
|
+
- 10.backend-api/05.business-logic.md — Service Layer, transactions, Celery
|
|
25
|
+
- 10.backend-api/06.admin-patterns.md — Admin customization, Inline, actions
|
|
26
26
|
- 30.security-db/01.security-auth.md — JWT, Permission, CORS, CSRF
|
|
27
|
-
- 30.security-db/02.database-schema.md —
|
|
28
|
-
- 30.security-db/03.common-utilities.md —
|
|
29
|
-
- 40.infra/01.environment-config.md —
|
|
30
|
-
- 40.infra/02.logging-monitoring.md —
|
|
31
|
-
- 40.infra/03.cicd-deployment.md — CI/CD, Docker,
|
|
32
|
-
- 50.verification/01.development-verification.md —
|
|
33
|
-
- 50.verification/02.testing-strategy.md — pytest, Factory,
|
|
27
|
+
- 30.security-db/02.database-schema.md — Migrations, fixtures, schema conventions
|
|
28
|
+
- 30.security-db/03.common-utilities.md — Common utils, custom Manager, constants
|
|
29
|
+
- 40.infra/01.environment-config.md — Settings separation, environment variables
|
|
30
|
+
- 40.infra/02.logging-monitoring.md — Logging standards, monitoring
|
|
31
|
+
- 40.infra/03.cicd-deployment.md — CI/CD, Docker, deployment strategy
|
|
32
|
+
- 50.verification/01.development-verification.md — Testing, startup, API testing
|
|
33
|
+
- 50.verification/02.testing-strategy.md — pytest, Factory, mocking, coverage
|
|
34
34
|
|
|
35
|
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
35
|
+
Each file MUST include:
|
|
36
|
+
- Correct examples (✅ code blocks)
|
|
37
|
+
- Incorrect examples (❌ code blocks)
|
|
38
|
+
- Key rules summary table
|
|
39
39
|
|
|
40
|
-
3. .claude/rules/ (
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
40
|
+
3. .claude/rules/ (active domains only)
|
|
41
|
+
- Each rule file must include paths: frontmatter
|
|
42
|
+
- Write 5-10 lines of key rules directly
|
|
43
|
+
- Reference detailed standards via @import
|
|
44
44
|
|
|
45
|
-
4. .claude/rules/50.sync/ (
|
|
45
|
+
4. .claude/rules/50.sync/ (3 sync rules)
|
|
46
46
|
- 01.standard-sync.md
|
|
47
47
|
- 02.rules-sync.md
|
|
48
48
|
- 03.skills-sync.md
|
|
49
49
|
|
|
50
|
-
5. claudeos-core/skills/ (
|
|
51
|
-
- 10.backend-crud/01.scaffold-crud-feature.md (
|
|
52
|
-
- 10.backend-crud/scaffold-crud-feature/01~08 (
|
|
53
|
-
- 00.shared/MANIFEST.md (
|
|
50
|
+
5. claudeos-core/skills/ (active domains only)
|
|
51
|
+
- 10.backend-crud/01.scaffold-crud-feature.md (orchestrator)
|
|
52
|
+
- 10.backend-crud/scaffold-crud-feature/01~08 (sub-skills: model, serializer, view, url, admin, migration, test, index)
|
|
53
|
+
- 00.shared/MANIFEST.md (skill registry)
|
|
54
54
|
|
|
55
|
-
6. claudeos-core/guide/ (
|
|
55
|
+
6. claudeos-core/guide/ (all)
|
|
56
56
|
- 01.onboarding/01.overview.md
|
|
57
57
|
- 01.onboarding/02.quickstart.md
|
|
58
58
|
- 01.onboarding/03.glossary.md
|
|
@@ -63,7 +63,7 @@ claudeos-core/generated/pass2-merged.json을 읽고,
|
|
|
63
63
|
- 04.architecture/01.file-map.md
|
|
64
64
|
- 04.architecture/02.pros-and-cons.md
|
|
65
65
|
|
|
66
|
-
7. claudeos-core/plan/ (
|
|
66
|
+
7. claudeos-core/plan/ (Master Plan)
|
|
67
67
|
- 10.standard-master.md
|
|
68
68
|
- 20.rules-master.md
|
|
69
69
|
- 21.sync-rules-master.md
|
|
@@ -71,8 +71,8 @@ claudeos-core/generated/pass2-merged.json을 읽고,
|
|
|
71
71
|
- 40.guides-master.md
|
|
72
72
|
|
|
73
73
|
8. claudeos-core/database/
|
|
74
|
-
- 01.schema-overview.md —
|
|
75
|
-
- 02.migration-guide.md —
|
|
74
|
+
- 01.schema-overview.md — Table list, relationship description
|
|
75
|
+
- 02.migration-guide.md — Migration procedure, squash, rollback
|
|
76
76
|
|
|
77
77
|
9. claudeos-core/mcp-guide/
|
|
78
|
-
- 01.mcp-overview.md —
|
|
78
|
+
- 01.mcp-overview.md — List of MCP servers in use, integration methods
|
|
@@ -1,97 +1,97 @@
|
|
|
1
|
-
claudeos-core/generated/project-analysis.json
|
|
2
|
-
|
|
1
|
+
Read claudeos-core/generated/project-analysis.json and
|
|
2
|
+
perform a deep analysis of the following domains only: {{DOMAIN_GROUP}}
|
|
3
3
|
|
|
4
|
-
|
|
5
|
-
|
|
4
|
+
For each domain, select one representative file per layer, read its code, and analyze it.
|
|
5
|
+
Prioritize files with the richest patterns.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Analysis items (per domain):
|
|
8
8
|
|
|
9
|
-
1. Router/Endpoint
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
- API
|
|
17
|
-
-
|
|
18
|
-
- API
|
|
9
|
+
1. Router/Endpoint Patterns
|
|
10
|
+
- Router structure (APIRouter, include_router, prefix, tags)
|
|
11
|
+
- Path decorators (@router.get, @router.post, @router.put, @router.delete)
|
|
12
|
+
- Parameter handling (Path, Query, Body, Header, Cookie, Depends)
|
|
13
|
+
- Response model (response_model, status_code, response_class)
|
|
14
|
+
- Error handling (HTTPException, exception_handler, custom exceptions)
|
|
15
|
+
- Authentication (Depends-based JWT/OAuth2, Security schemes)
|
|
16
|
+
- API documentation (auto OpenAPI, tags, summary, description, deprecated)
|
|
17
|
+
- Pagination (offset/limit, cursor, custom)
|
|
18
|
+
- API versioning (prefix, router separation)
|
|
19
19
|
|
|
20
|
-
2. Schema/Pydantic
|
|
21
|
-
- Pydantic
|
|
22
|
-
-
|
|
23
|
-
- Request/Response
|
|
20
|
+
2. Schema/Pydantic Patterns
|
|
21
|
+
- Pydantic model structure (BaseModel, inheritance, Generic)
|
|
22
|
+
- Validation (@field_validator, @model_validator, BeforeValidator)
|
|
23
|
+
- Request/Response schema separation
|
|
24
24
|
- Config (model_config, from_attributes, json_schema_extra)
|
|
25
|
-
- Optional/Union
|
|
26
|
-
- Enum/Literal
|
|
27
|
-
-
|
|
25
|
+
- Optional/Union field handling
|
|
26
|
+
- Enum/Literal usage
|
|
27
|
+
- Nested models
|
|
28
28
|
|
|
29
|
-
3.
|
|
29
|
+
3. Data Access Patterns
|
|
30
30
|
- ORM (SQLAlchemy 2.0, Tortoise ORM, SQLModel, Beanie/Motor)
|
|
31
|
-
-
|
|
32
|
-
- Repository/CRUD
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
31
|
+
- Session management (get_db, AsyncSession, contextmanager)
|
|
32
|
+
- Repository/CRUD pattern (Generic Repository, abstraction level)
|
|
33
|
+
- Migration (Alembic, autogenerate, manual)
|
|
34
|
+
- Query optimization (eager loading, selectinload, joinedload)
|
|
35
|
+
- Connection management (pool, retry, async)
|
|
36
|
+
- Dynamic query/filtering
|
|
37
37
|
|
|
38
|
-
4.
|
|
39
|
-
- Depends
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
38
|
+
4. Dependency Injection Patterns
|
|
39
|
+
- Depends chain (auth, DB session, permissions, config)
|
|
40
|
+
- Dependency hierarchy (nested Depends)
|
|
41
|
+
- Custom dependency functions/classes
|
|
42
|
+
- Lifecycle events (lifespan, startup/shutdown)
|
|
43
|
+
- Dependency overrides (for testing)
|
|
44
44
|
|
|
45
|
-
5.
|
|
46
|
-
-
|
|
47
|
-
- Settings
|
|
48
|
-
-
|
|
49
|
-
-
|
|
45
|
+
5. Configuration/Environment Patterns
|
|
46
|
+
- Environment variable management (pydantic-settings, python-dotenv)
|
|
47
|
+
- Settings class structure (@lru_cache, singleton)
|
|
48
|
+
- Per-environment branching (development/staging/production)
|
|
49
|
+
- Configuration validation
|
|
50
50
|
|
|
51
|
-
6.
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
51
|
+
6. Logging Patterns
|
|
52
|
+
- Logger usage (structlog, loguru, logging)
|
|
53
|
+
- Log level policy
|
|
54
|
+
- Structured logging (JSON format, correlation ID)
|
|
55
|
+
- Request/response logging (middleware)
|
|
56
|
+
- Async logging
|
|
57
57
|
|
|
58
|
-
7.
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
63
|
-
- Fixture
|
|
64
|
-
- DB
|
|
65
|
-
-
|
|
58
|
+
7. Testing Patterns
|
|
59
|
+
- Test framework (pytest, pytest-asyncio, httpx)
|
|
60
|
+
- Test classification (unit/integration/E2E)
|
|
61
|
+
- Test client (TestClient, AsyncClient)
|
|
62
|
+
- Dependency override strategy
|
|
63
|
+
- Fixture management (conftest, factory)
|
|
64
|
+
- DB test strategy (test DB, SQLite in-memory, transaction rollback)
|
|
65
|
+
- Mocking (unittest.mock, pytest-mock, responses, respx)
|
|
66
66
|
|
|
67
|
-
8.
|
|
67
|
+
8. Middleware Patterns
|
|
68
68
|
- CORS Middleware
|
|
69
|
-
-
|
|
70
|
-
- Middleware
|
|
71
|
-
- Starlette Middleware
|
|
69
|
+
- Custom middleware (logging, auth, performance measurement)
|
|
70
|
+
- Middleware registration order
|
|
71
|
+
- Starlette Middleware usage
|
|
72
72
|
|
|
73
|
-
9.
|
|
74
|
-
-
|
|
73
|
+
9. Domain-Specific Patterns
|
|
74
|
+
- File upload (UploadFile, S3, presigned URL)
|
|
75
75
|
- WebSocket (websocket endpoint)
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
76
|
+
- Background tasks (BackgroundTasks, Celery, ARQ, Dramatiq)
|
|
77
|
+
- External API integration (httpx, aiohttp)
|
|
78
|
+
- Caching (Redis, fastapi-cache, aiocache)
|
|
79
|
+
- Event-driven (async/await, pub/sub)
|
|
80
|
+
- Messaging (Kafka, RabbitMQ, aio-pika)
|
|
81
|
+
- Internationalization
|
|
82
82
|
- Rate Limiting (slowapi)
|
|
83
83
|
- GraphQL (Strawberry)
|
|
84
84
|
|
|
85
|
-
10.
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
- Depends
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
85
|
+
10. Anti-patterns / Inconsistencies
|
|
86
|
+
- Sync/async mixing
|
|
87
|
+
- Missing type hints
|
|
88
|
+
- Depends overuse or non-use
|
|
89
|
+
- Legacy-looking patterns
|
|
90
|
+
- Security issues (injection, missing authorization)
|
|
91
|
+
- Performance issues (blocking I/O, N+1)
|
|
92
92
|
|
|
93
|
-
|
|
94
|
-
|
|
93
|
+
Do not create files. Analysis only.
|
|
94
|
+
Save results to claudeos-core/generated/pass1-{{PASS_NUM}}.json in the following format:
|
|
95
95
|
|
|
96
96
|
{
|
|
97
97
|
"analyzedAt": "ISO timestamp",
|
|
@@ -121,7 +121,7 @@ claudeos-core/generated/project-analysis.json을 읽고,
|
|
|
121
121
|
}
|
|
122
122
|
},
|
|
123
123
|
"crossDomainCommon": {
|
|
124
|
-
"description": "
|
|
124
|
+
"description": "Patterns commonly used across domains in this group",
|
|
125
125
|
"patterns": []
|
|
126
126
|
}
|
|
127
127
|
}
|
|
@@ -1,83 +1,83 @@
|
|
|
1
|
-
claudeos-core/generated/
|
|
2
|
-
|
|
1
|
+
Read all pass1-*.json files from the claudeos-core/generated/ directory and
|
|
2
|
+
merge all domain analysis results into a single unified report.
|
|
3
3
|
|
|
4
|
-
|
|
4
|
+
Merge items:
|
|
5
5
|
|
|
6
|
-
1.
|
|
7
|
-
- Router/Endpoint
|
|
8
|
-
- Schema/Pydantic
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
6
|
+
1. Universal Patterns (shared by 100% of all domains)
|
|
7
|
+
- Router/Endpoint style (decorators, response models, status codes)
|
|
8
|
+
- Schema/Pydantic conventions (BaseModel, validation)
|
|
9
|
+
- Data access patterns (ORM, session management)
|
|
10
|
+
- Dependency injection chain (Depends)
|
|
11
|
+
- Error handling patterns
|
|
12
|
+
- Middleware chain
|
|
13
13
|
|
|
14
|
-
2.
|
|
15
|
-
-
|
|
14
|
+
2. Majority Patterns (shared by 50%+ of domains)
|
|
15
|
+
- Specify which domains share them
|
|
16
16
|
|
|
17
|
-
3.
|
|
18
|
-
-
|
|
19
|
-
- WebSocket:
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
17
|
+
3. Domain-Specific Patterns (unique to a single domain)
|
|
18
|
+
- File upload: which domain
|
|
19
|
+
- WebSocket: which domain
|
|
20
|
+
- Background tasks: which domain
|
|
21
|
+
- External API: which domain
|
|
22
|
+
- Caching: which domain
|
|
23
|
+
- Messaging: which domain
|
|
24
24
|
|
|
25
|
-
4.
|
|
26
|
-
-
|
|
27
|
-
-
|
|
25
|
+
4. Anti-pattern Summary
|
|
26
|
+
- Consolidate all inconsistencies found across domains
|
|
27
|
+
- Classify by severity (CRITICAL / HIGH / MEDIUM / LOW)
|
|
28
28
|
|
|
29
|
-
5.
|
|
30
|
-
-
|
|
31
|
-
- Schema/Model
|
|
32
|
-
-
|
|
33
|
-
-
|
|
29
|
+
5. Naming Conventions Summary
|
|
30
|
+
- Module/package naming (snake_case)
|
|
31
|
+
- Schema/Model naming conventions
|
|
32
|
+
- Router URL patterns
|
|
33
|
+
- File structure conventions
|
|
34
34
|
|
|
35
|
-
6.
|
|
36
|
-
- Base
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
35
|
+
6. Common Models/Utilities List
|
|
36
|
+
- Base model fields
|
|
37
|
+
- Shared dependency functions
|
|
38
|
+
- Utility functions
|
|
39
|
+
- Constants/Enum management
|
|
40
40
|
|
|
41
|
-
7.
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
- CORS
|
|
41
|
+
7. Security/Authentication Patterns
|
|
42
|
+
- Authentication method (JWT Bearer, OAuth2PasswordBearer)
|
|
43
|
+
- Depends-based authorization check
|
|
44
|
+
- CORS configuration
|
|
45
45
|
- Rate Limiting
|
|
46
|
-
-
|
|
46
|
+
- Environment variable management
|
|
47
47
|
|
|
48
|
-
8.
|
|
49
|
-
-
|
|
50
|
-
- Alembic
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
48
|
+
8. Database Patterns
|
|
49
|
+
- Table naming (__tablename__)
|
|
50
|
+
- Alembic migration strategy
|
|
51
|
+
- Seed data management
|
|
52
|
+
- Audit fields (created_at, updated_at)
|
|
53
|
+
- Async DB access patterns
|
|
54
|
+
- Index/constraints
|
|
55
55
|
|
|
56
|
-
9.
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
- Fixture/Factory
|
|
62
|
-
-
|
|
56
|
+
9. Testing Strategy Summary
|
|
57
|
+
- Test coverage level
|
|
58
|
+
- Test classification system (unit/integration/E2E)
|
|
59
|
+
- Dependency override strategy
|
|
60
|
+
- Async testing approach
|
|
61
|
+
- Fixture/Factory strategy
|
|
62
|
+
- Mocking strategy
|
|
63
63
|
|
|
64
|
-
10.
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
64
|
+
10. Logging/Monitoring Strategy
|
|
65
|
+
- Logger standard
|
|
66
|
+
- Log level policy
|
|
67
|
+
- Structured logging approach
|
|
68
|
+
- Request/response logging
|
|
69
69
|
|
|
70
|
-
11.
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
70
|
+
11. Performance Patterns
|
|
71
|
+
- Caching strategy
|
|
72
|
+
- Async processing status
|
|
73
|
+
- Connection pool configuration
|
|
74
|
+
- Query optimization
|
|
75
75
|
|
|
76
|
-
12.
|
|
77
|
-
- Lint/Format
|
|
78
|
-
- Pre-commit
|
|
76
|
+
12. Code Quality Tools
|
|
77
|
+
- Lint/Format tools (ruff, black, isort, mypy)
|
|
78
|
+
- Pre-commit hooks
|
|
79
79
|
- Type Checking (mypy, pyright)
|
|
80
|
-
- CI
|
|
80
|
+
- CI integration status
|
|
81
81
|
|
|
82
|
-
|
|
83
|
-
|
|
82
|
+
Do not generate code. Merge only.
|
|
83
|
+
Save results to claudeos-core/generated/pass2-merged.json.
|