# Pitfall Log

Project: kedro-org/kedro

Summary: Found 31 structured pitfall item(s), including 5 high/blocking item(s). Top priority: Installation risk - Installation risk requires verification.

## 1. Installation risk - Installation risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5582

## 2. Installation risk - Installation risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5305

## 3. Installation risk - Installation risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5601

## 4. Installation risk - Installation risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5600

## 5. Maintenance risk - Maintenance risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5304

## 6. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: 1.0.0
- User impact: Upgrade or migration may change expected behavior: 1.0.0
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.0.0

## 7. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: 1.1.0
- User impact: Upgrade or migration may change expected behavior: 1.1.0
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.1.0

## 8. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: 1.2.0
- User impact: Upgrade or migration may change expected behavior: 1.2.0
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.2.0

## 9. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: 1.3.0
- User impact: Upgrade or migration may change expected behavior: 1.3.0
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.3.0

## 10. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: 1.4.0
- User impact: Upgrade or migration may change expected behavior: 1.4.0
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.4.0

## 11. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5603

## 12. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5592

## 13. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5515

## 14. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/kedro-org/kedro/issues/5607

## 15. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Packages settings are not used when running a package pipeline from project root dir
- User impact: Developers may misconfigure credentials, environment, or host setup: Packages settings are not used when running a package pipeline from project root dir
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5515

## 16. Configuration risk - Configuration risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this configuration risk before relying on the project: Review & update Kedro deployment docs for AWS Step Functions
- User impact: Developers may misconfigure credentials, environment, or host setup: Review & update Kedro deployment docs for AWS Step Functions
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5364

## 17. Capability evidence risk - Capability evidence risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: README/documentation is current enough for a first validation pass.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: capability.assumptions | https://github.com/kedro-org/kedro

## 18. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: 0.19.15
- User impact: Upgrade or migration may change expected behavior: 0.19.15
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/0.19.15

## 19. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: 1.0.0rc3
- User impact: Upgrade or migration may change expected behavior: 1.0.0rc3
- Evidence: failure_mode_cluster:github_release | https://github.com/kedro-org/kedro/releases/tag/1.0.0rc3

## 20. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: Document how to add docs with MkDocs when the docs tool is not selected
- User impact: Developers may hit a documented source-backed failure mode: Document how to add docs with MkDocs when the docs tool is not selected
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5603

## 21. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: Fix the `docs` tool so generated Sphinx docs build correctly
- User impact: Developers may hit a documented source-backed failure mode: Fix the `docs` tool so generated Sphinx docs build correctly
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5592

## 22. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this migration risk before relying on the project: kedro new accepts project names that shadow Python stdlib modules / keywords, silently producing a broken project
- User impact: Developers may hit a documented source-backed failure mode: kedro new accepts project names that shadow Python stdlib modules / keywords, silently producing a broken project
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5607

## 23. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/kedro-org/kedro

## 24. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: downstream_validation.risk_items | https://github.com/kedro-org/kedro

## 25. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: risks.scoring_risks | https://github.com/kedro-org/kedro

## 26. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: Add exclude_pipelines parameter to find_pipelines
- User impact: Developers may hit a documented source-backed failure mode: Add exclude_pipelines parameter to find_pipelines
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5582

## 27. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: Kedro x MLRun
- User impact: Developers may hit a documented source-backed failure mode: Kedro x MLRun
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5305

## 28. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this capability risk before relying on the project: ci: Nightly build failure on `develop`
- User impact: Developers may hit a documented source-backed failure mode: ci: Nightly build failure on `develop`
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5601

## 29. Capability evidence risk - Capability evidence risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: Developers should check this conceptual risk before relying on the project: Revise and update AWS deployment docs
- User impact: Developers may hit a documented source-backed failure mode: Revise and update AWS deployment docs
- Evidence: failure_mode_cluster:github_issue | https://github.com/kedro-org/kedro/issues/5304

## 30. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: issue_or_pr_quality=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/kedro-org/kedro

## 31. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: release_recency=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Evidence: evidence.maintainer_signals | https://github.com/kedro-org/kedro