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.
Files changed (80) hide show
  1. package/.clinerules/maurao-method.md +6 -0
  2. package/.cursor/rules/maurao-method.mdc +7 -0
  3. package/.github/copilot-instructions.md +6 -0
  4. package/.github/workflows/ci.yml +39 -0
  5. package/.github/workflows/publish.yml +32 -0
  6. package/.github/workflows/release-on-main.yml +87 -0
  7. package/.maurao/README.md +13 -0
  8. package/.maurao/config.json +17 -0
  9. package/AGENTS.md +30 -0
  10. package/CLAUDE.md +6 -0
  11. package/GEMINI.md +6 -0
  12. package/README.md +110 -2
  13. package/bin/maurao.mjs +218 -0
  14. package/commands/debug.md +4 -0
  15. package/commands/discover.md +4 -0
  16. package/commands/map.md +4 -0
  17. package/commands/plan.md +4 -0
  18. package/commands/pr.md +4 -0
  19. package/commands/review.md +4 -0
  20. package/commands/specify.md +4 -0
  21. package/commands/spike.md +4 -0
  22. package/commands/verify.md +4 -0
  23. package/docs/artifact-contract.md +22 -0
  24. package/docs/commands.md +32 -0
  25. package/docs/method-overview.md +32 -0
  26. package/docs/npm-release.md +68 -0
  27. package/docs/portable-adapters.md +26 -0
  28. package/docs/project-modes.md +33 -0
  29. package/docs/specification-standard.md +25 -0
  30. package/docs/tool-support.md +24 -0
  31. package/docs/workflow.md +45 -0
  32. package/package.json +42 -4
  33. package/skills/core/architecture/SKILL.md +16 -0
  34. package/skills/core/brownfield-analysis/SKILL.md +20 -0
  35. package/skills/core/debugging/SKILL.md +32 -0
  36. package/skills/core/planning/SKILL.md +18 -0
  37. package/skills/core/product-discovery/SKILL.md +20 -0
  38. package/skills/core/project-discovery/SKILL.md +32 -0
  39. package/skills/core/requirements/SKILL.md +13 -0
  40. package/skills/core/specification/SKILL.md +41 -0
  41. package/skills/core/spike/SKILL.md +30 -0
  42. package/skills/core/technology-discovery/SKILL.md +43 -0
  43. package/skills/practices/code-review/SKILL.md +21 -0
  44. package/skills/practices/data-migration/SKILL.md +14 -0
  45. package/skills/practices/observability/SKILL.md +28 -0
  46. package/skills/practices/observability/checklist.md +11 -0
  47. package/skills/practices/observability/references/dotnet.md +7 -0
  48. package/skills/practices/observability/references/java.md +9 -0
  49. package/skills/practices/observability/references/node.md +7 -0
  50. package/skills/practices/observability/references/python.md +7 -0
  51. package/skills/practices/observability/templates/logging-plan.md +16 -0
  52. package/skills/practices/observability/templates/metrics-plan.md +6 -0
  53. package/skills/practices/observability/templates/tracing-plan.md +14 -0
  54. package/skills/practices/pull-request/SKILL.md +17 -0
  55. package/skills/practices/release-readiness/SKILL.md +20 -0
  56. package/skills/practices/security/SKILL.md +11 -0
  57. package/skills/practices/testing/SKILL.md +37 -0
  58. package/skills/practices/verification/SKILL.md +15 -0
  59. package/skills/workflows/brownfield-change/SKILL.md +26 -0
  60. package/skills/workflows/bug-fix/SKILL.md +19 -0
  61. package/skills/workflows/feature-development/SKILL.md +35 -0
  62. package/skills/workflows/greenfield-product/SKILL.md +28 -0
  63. package/technology-packs/dotnet/README.md +6 -0
  64. package/technology-packs/java/README.md +34 -0
  65. package/technology-packs/node/README.md +6 -0
  66. package/technology-packs/python/README.md +6 -0
  67. package/templates/brownfield-map.md +38 -0
  68. package/templates/bug-fix.md +36 -0
  69. package/templates/change-proposal.md +40 -0
  70. package/templates/decision-record.md +33 -0
  71. package/templates/feature-spec.md +50 -0
  72. package/templates/implementation-plan.md +33 -0
  73. package/templates/product-brief.md +41 -0
  74. package/templates/pull-request.md +27 -0
  75. package/templates/spike-report.md +36 -0
  76. package/templates/system-context.md +36 -0
  77. package/templates/technology-inventory.md +38 -0
  78. package/templates/test-plan.md +23 -0
  79. package/templates/threat-model.md +31 -0
  80. 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
+