maurao-method 0.0.0-stage → 0.1.2
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/.clinerules/maurao-method.md +6 -0
- package/.cursor/rules/maurao-method.mdc +7 -0
- package/.github/copilot-instructions.md +6 -0
- package/.github/workflows/ci.yml +39 -0
- package/.github/workflows/publish.yml +32 -0
- package/.github/workflows/release-on-main.yml +87 -0
- package/.maurao/README.md +13 -0
- package/.maurao/config.json +17 -0
- package/AGENTS.md +30 -0
- package/CLAUDE.md +6 -0
- package/GEMINI.md +6 -0
- package/README.md +110 -2
- package/bin/maurao.mjs +218 -0
- package/commands/debug.md +4 -0
- package/commands/discover.md +4 -0
- package/commands/map.md +4 -0
- package/commands/plan.md +4 -0
- package/commands/pr.md +4 -0
- package/commands/review.md +4 -0
- package/commands/specify.md +4 -0
- package/commands/spike.md +4 -0
- package/commands/verify.md +4 -0
- package/docs/artifact-contract.md +22 -0
- package/docs/commands.md +32 -0
- package/docs/method-overview.md +32 -0
- package/docs/npm-release.md +68 -0
- package/docs/portable-adapters.md +26 -0
- package/docs/project-modes.md +33 -0
- package/docs/specification-standard.md +25 -0
- package/docs/tool-support.md +24 -0
- package/docs/workflow.md +45 -0
- package/package.json +42 -4
- package/skills/core/architecture/SKILL.md +16 -0
- package/skills/core/brownfield-analysis/SKILL.md +20 -0
- package/skills/core/debugging/SKILL.md +32 -0
- package/skills/core/planning/SKILL.md +18 -0
- package/skills/core/product-discovery/SKILL.md +20 -0
- package/skills/core/project-discovery/SKILL.md +32 -0
- package/skills/core/requirements/SKILL.md +13 -0
- package/skills/core/specification/SKILL.md +41 -0
- package/skills/core/spike/SKILL.md +30 -0
- package/skills/core/technology-discovery/SKILL.md +43 -0
- package/skills/practices/code-review/SKILL.md +21 -0
- package/skills/practices/data-migration/SKILL.md +14 -0
- package/skills/practices/observability/SKILL.md +28 -0
- package/skills/practices/observability/checklist.md +11 -0
- package/skills/practices/observability/references/dotnet.md +7 -0
- package/skills/practices/observability/references/java.md +9 -0
- package/skills/practices/observability/references/node.md +7 -0
- package/skills/practices/observability/references/python.md +7 -0
- package/skills/practices/observability/templates/logging-plan.md +16 -0
- package/skills/practices/observability/templates/metrics-plan.md +6 -0
- package/skills/practices/observability/templates/tracing-plan.md +14 -0
- package/skills/practices/pull-request/SKILL.md +17 -0
- package/skills/practices/release-readiness/SKILL.md +20 -0
- package/skills/practices/security/SKILL.md +11 -0
- package/skills/practices/testing/SKILL.md +37 -0
- package/skills/practices/verification/SKILL.md +15 -0
- package/skills/workflows/brownfield-change/SKILL.md +26 -0
- package/skills/workflows/bug-fix/SKILL.md +19 -0
- package/skills/workflows/feature-development/SKILL.md +35 -0
- package/skills/workflows/greenfield-product/SKILL.md +28 -0
- package/technology-packs/dotnet/README.md +6 -0
- package/technology-packs/java/README.md +34 -0
- package/technology-packs/node/README.md +6 -0
- package/technology-packs/python/README.md +6 -0
- package/templates/brownfield-map.md +38 -0
- package/templates/bug-fix.md +36 -0
- package/templates/change-proposal.md +40 -0
- package/templates/decision-record.md +33 -0
- package/templates/feature-spec.md +50 -0
- package/templates/implementation-plan.md +33 -0
- package/templates/product-brief.md +41 -0
- package/templates/pull-request.md +27 -0
- package/templates/spike-report.md +36 -0
- package/templates/system-context.md +36 -0
- package/templates/technology-inventory.md +38 -0
- package/templates/test-plan.md +23 -0
- package/templates/threat-model.md +31 -0
- package/templates/verification-report.md +26 -0
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Product Brief: <product name>
|
|
2
|
+
|
|
3
|
+
## Problem
|
|
4
|
+
|
|
5
|
+
Who has which problem, in what context, and why does it matter?
|
|
6
|
+
|
|
7
|
+
## Users and stakeholders
|
|
8
|
+
|
|
9
|
+
| Group | Goal | Pain | Evidence |
|
|
10
|
+
|---|---|---|---|
|
|
11
|
+
| | | | |
|
|
12
|
+
|
|
13
|
+
## Desired outcome
|
|
14
|
+
|
|
15
|
+
What measurable change should the product create?
|
|
16
|
+
|
|
17
|
+
## Non-goals
|
|
18
|
+
|
|
19
|
+
-
|
|
20
|
+
|
|
21
|
+
## Constraints
|
|
22
|
+
|
|
23
|
+
- Business:
|
|
24
|
+
- Technical:
|
|
25
|
+
- Regulatory or security:
|
|
26
|
+
- Operational:
|
|
27
|
+
|
|
28
|
+
## Smallest useful slice
|
|
29
|
+
|
|
30
|
+
Describe the smallest end-to-end capability that can validate the core assumption.
|
|
31
|
+
|
|
32
|
+
## Success measures
|
|
33
|
+
|
|
34
|
+
| Measure | Baseline | Target | How measured |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| | | | |
|
|
37
|
+
|
|
38
|
+
## Open questions
|
|
39
|
+
|
|
40
|
+
-
|
|
41
|
+
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Pull Request: <short title>
|
|
2
|
+
|
|
3
|
+
## Summary
|
|
4
|
+
|
|
5
|
+
-
|
|
6
|
+
|
|
7
|
+
## Specification
|
|
8
|
+
|
|
9
|
+
- Link or path:
|
|
10
|
+
|
|
11
|
+
## Validation
|
|
12
|
+
|
|
13
|
+
- Tests:
|
|
14
|
+
- Lint:
|
|
15
|
+
- Build:
|
|
16
|
+
- Manual checks:
|
|
17
|
+
|
|
18
|
+
## Risk and rollout
|
|
19
|
+
|
|
20
|
+
- Risk:
|
|
21
|
+
- Rollback:
|
|
22
|
+
- Observability:
|
|
23
|
+
|
|
24
|
+
## Reviewer focus
|
|
25
|
+
|
|
26
|
+
-
|
|
27
|
+
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Spike Report: <question>
|
|
2
|
+
|
|
3
|
+
## Question
|
|
4
|
+
|
|
5
|
+
What uncertainty must this spike resolve?
|
|
6
|
+
|
|
7
|
+
## Constraints
|
|
8
|
+
|
|
9
|
+
- Time or effort budget:
|
|
10
|
+
- Runtime or infrastructure constraints:
|
|
11
|
+
- Success criteria:
|
|
12
|
+
|
|
13
|
+
## Alternatives
|
|
14
|
+
|
|
15
|
+
-
|
|
16
|
+
|
|
17
|
+
## Experiment
|
|
18
|
+
|
|
19
|
+
Describe the smallest experiment that can produce useful evidence.
|
|
20
|
+
|
|
21
|
+
## Observations
|
|
22
|
+
|
|
23
|
+
-
|
|
24
|
+
|
|
25
|
+
## Decision
|
|
26
|
+
|
|
27
|
+
Choose, reject, defer, or mark inconclusive.
|
|
28
|
+
|
|
29
|
+
## Limitations
|
|
30
|
+
|
|
31
|
+
-
|
|
32
|
+
|
|
33
|
+
## Follow-up
|
|
34
|
+
|
|
35
|
+
If implementation is approved, create a separate feature specification.
|
|
36
|
+
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# System Context: <system name>
|
|
2
|
+
|
|
3
|
+
## Repository and runtime inventory
|
|
4
|
+
|
|
5
|
+
- Repository structure:
|
|
6
|
+
- Entry points:
|
|
7
|
+
- Runtime and deployment:
|
|
8
|
+
- Build and test commands:
|
|
9
|
+
- Configuration and secrets:
|
|
10
|
+
|
|
11
|
+
## Components
|
|
12
|
+
|
|
13
|
+
| Component | Responsibility | Owner | Dependencies |
|
|
14
|
+
|---|---|---|---|
|
|
15
|
+
| | | | |
|
|
16
|
+
|
|
17
|
+
## External boundaries
|
|
18
|
+
|
|
19
|
+
| Boundary | Protocol or contract | Data exchanged | Failure behavior |
|
|
20
|
+
|---|---|---|---|
|
|
21
|
+
| | | | |
|
|
22
|
+
|
|
23
|
+
## Data flows
|
|
24
|
+
|
|
25
|
+
Describe the important request, event, job, and persistence flows.
|
|
26
|
+
|
|
27
|
+
## Invariants
|
|
28
|
+
|
|
29
|
+
Behavior and contracts that must not change accidentally:
|
|
30
|
+
|
|
31
|
+
-
|
|
32
|
+
|
|
33
|
+
## Unknowns and risks
|
|
34
|
+
|
|
35
|
+
-
|
|
36
|
+
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Technology Inventory: <project or application>
|
|
2
|
+
|
|
3
|
+
## Project scope
|
|
4
|
+
|
|
5
|
+
- Mode: Greenfield / Brownfield / Hybrid
|
|
6
|
+
- Repository or package:
|
|
7
|
+
- Date:
|
|
8
|
+
|
|
9
|
+
## Detected technologies
|
|
10
|
+
|
|
11
|
+
| Area | Technology | Version | Evidence | Confidence | Active? |
|
|
12
|
+
|---|---|---|---|---|---|
|
|
13
|
+
| Language | | | | High / Medium / Low | Yes / No |
|
|
14
|
+
| Runtime | | | | | |
|
|
15
|
+
| Framework | | | | | |
|
|
16
|
+
| Build | | | | | |
|
|
17
|
+
| Test | | | | | |
|
|
18
|
+
| Lint / Format | | | | | |
|
|
19
|
+
| Deploy | | | | | |
|
|
20
|
+
|
|
21
|
+
## Commands
|
|
22
|
+
|
|
23
|
+
| Purpose | Command | Source | Confirmed by execution? |
|
|
24
|
+
|---|---|---|---|
|
|
25
|
+
| Install | | | No |
|
|
26
|
+
| Run | | | No |
|
|
27
|
+
| Test | | | No |
|
|
28
|
+
| Lint | | | No |
|
|
29
|
+
| Build | | | No |
|
|
30
|
+
|
|
31
|
+
## Active technology packs
|
|
32
|
+
|
|
33
|
+
-
|
|
34
|
+
|
|
35
|
+
## Unknowns and next checks
|
|
36
|
+
|
|
37
|
+
-
|
|
38
|
+
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Test Plan: <change name>
|
|
2
|
+
|
|
3
|
+
## Behavioral coverage
|
|
4
|
+
|
|
5
|
+
| Acceptance criterion | Test level | Test ID | Data or setup |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| AC-001 | Unit / Integration / Contract / E2E | TEST-001 | |
|
|
8
|
+
|
|
9
|
+
## Negative paths and boundaries
|
|
10
|
+
|
|
11
|
+
-
|
|
12
|
+
|
|
13
|
+
## Compatibility
|
|
14
|
+
|
|
15
|
+
- Existing behavior that must remain:
|
|
16
|
+
- Contracts that must remain compatible:
|
|
17
|
+
|
|
18
|
+
## Test execution
|
|
19
|
+
|
|
20
|
+
| Command | Environment | Result |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| | | Not run |
|
|
23
|
+
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Threat Model: <change or system>
|
|
2
|
+
|
|
3
|
+
## Scope
|
|
4
|
+
|
|
5
|
+
- System or change:
|
|
6
|
+
- Assets:
|
|
7
|
+
- Trust boundaries:
|
|
8
|
+
- Out of scope:
|
|
9
|
+
|
|
10
|
+
## Actors and entry points
|
|
11
|
+
|
|
12
|
+
| Actor | Entry point | Capability | Trust level |
|
|
13
|
+
|---|---|---|---|
|
|
14
|
+
| | | | |
|
|
15
|
+
|
|
16
|
+
## Threats
|
|
17
|
+
|
|
18
|
+
| ID | Threat | Asset or boundary | Likelihood | Impact | Mitigation | Residual risk |
|
|
19
|
+
|---|---|---|---|---|---|---|
|
|
20
|
+
| THR-001 | | | Low / Medium / High | Low / Medium / High | | |
|
|
21
|
+
|
|
22
|
+
## Security requirements
|
|
23
|
+
|
|
24
|
+
- SEC-001:
|
|
25
|
+
|
|
26
|
+
## Verification
|
|
27
|
+
|
|
28
|
+
- Test or check:
|
|
29
|
+
- Manual review:
|
|
30
|
+
- Remaining uncertainty:
|
|
31
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Verification Report: <change>
|
|
2
|
+
|
|
3
|
+
## Change verified
|
|
4
|
+
|
|
5
|
+
- Specification or issue:
|
|
6
|
+
- Working tree reference:
|
|
7
|
+
|
|
8
|
+
## Checks executed
|
|
9
|
+
|
|
10
|
+
| Check | Command | Result |
|
|
11
|
+
|---|---|---|
|
|
12
|
+
| Tests | `<command>` | Passed / Failed / Not run |
|
|
13
|
+
| Lint | `<command>` | Passed / Failed / Not run |
|
|
14
|
+
| Build | `<command>` | Passed / Failed / Not run |
|
|
15
|
+
| Review | `<method>` | Passed / Findings |
|
|
16
|
+
|
|
17
|
+
## Acceptance criteria
|
|
18
|
+
|
|
19
|
+
| Criterion | Evidence | Result |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| AC-001 | | Verified / Not verified |
|
|
22
|
+
|
|
23
|
+
## Known limitations
|
|
24
|
+
|
|
25
|
+
-
|
|
26
|
+
|